oh-my-codex 0.10.2 → 0.10.3

package/dist/agents/__tests__/skill-bridge.test.js

@@ -0,0 +1,71 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { buildSkillBridgeResolutionGuidance, generateSkillBridgeAgentToml, listInstalledSkillBridgeAgents, } from '../skill-bridge.js';
+describe('agents/skill-bridge', () => {
+    it('generates lightweight bridge TOML without developer instructions', () => {
+        const toml = generateSkillBridgeAgentToml({
+            name: 'code-review',
+            description: 'Run a comprehensive code review',
+            skillRef: 'code-review',
+        });
+        assert.match(toml, /# oh-my-codex skill bridge agent: code-review/);
+        assert.match(toml, /^skill_ref = "code-review"$/m);
+        assert.doesNotMatch(toml, /developer_instructions\s*=/);
+    });
+    it('discovers installed skill bridge agents and emits Codex-home-first guidance', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'omx-skill-bridge-'));
+        const home = join(wd, 'home');
+        const previousHome = process.env.HOME;
+        const previousCodexHome = process.env.CODEX_HOME;
+        process.env.HOME = home;
+        process.env.CODEX_HOME = join(home, '.codex');
+        try {
+            const projectAgentsDir = join(wd, '.codex', 'agents');
+            const userAgentsDir = join(home, '.codex', 'agents');
+            const userSkillsPath = join(home, '.codex', 'skills', 'plan');
+            const legacyProjectSkillsPath = join(wd, '.agents', 'skills', 'code-review');
+            await mkdir(projectAgentsDir, { recursive: true });
+            await mkdir(userAgentsDir, { recursive: true });
+            await mkdir(userSkillsPath, { recursive: true });
+            await mkdir(legacyProjectSkillsPath, { recursive: true });
+            await writeFile(join(userSkillsPath, 'SKILL.md'), '# user plan\n');
+            await writeFile(join(legacyProjectSkillsPath, 'SKILL.md'), '# legacy project review\n');
+            await writeFile(join(projectAgentsDir, 'plan.toml'), generateSkillBridgeAgentToml({
+                name: 'plan',
+                description: 'Strategic planning',
+                skillRef: 'plan',
+            }));
+            await writeFile(join(userAgentsDir, 'code-review.toml'), generateSkillBridgeAgentToml({
+                name: 'code-review',
+                description: 'Review code',
+                skillRef: 'code-review',
+            }));
+            const bridges = await listInstalledSkillBridgeAgents(wd);
+            assert.deepEqual(bridges.map((item) => [item.scope, item.name, item.skillRef]), [
+                ['project', 'plan', 'plan'],
+                ['user', 'code-review', 'code-review'],
+            ]);
+            const guidance = await buildSkillBridgeResolutionGuidance(wd);
+            assert.match(guidance, /Native Skill Bridge/);
+            assert.match(guidance, new RegExp(`${join(home, '.codex', 'skills').replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}/<skill>/SKILL\.md`));
+            assert.match(guidance, /primary Codex skills path/);
+            assert.match(guidance, /legacy project fallback/);
+            assert.match(guidance, /legacy compatibility fallback/);
+        }
+        finally {
+            if (typeof previousHome === 'string')
+                process.env.HOME = previousHome;
+            else
+                delete process.env.HOME;
+            if (typeof previousCodexHome === 'string')
+                process.env.CODEX_HOME = previousCodexHome;
+            else
+                delete process.env.CODEX_HOME;
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=skill-bridge.test.js.map

package/dist/agents/__tests__/skill-bridge.test.js.map

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

package/dist/agents/native-config.d.ts

@@ -1,15 +1,27 @@
 /**
- * Native agent config generator for Codex CLI multi-agent roles
- * Generates per-agent .toml files at ~/.omx/agents/<name>.toml
+ * Native agent config generators for Codex CLI.
+ * Writes standalone TOML files under ~/.codex/agents/ or ./.codex/agents/.
  */
-import { AgentDefinition } from './definitions.js';
+import { AgentDefinition } from "./definitions.js";
+export interface GeneratedNativeAgentConfig {
+    name: string;
+    description: string;
+    developerInstructions?: string;
+    model?: string;
+    reasoningEffort?: "low" | "medium" | "high" | "xhigh";
+}
 /**
- * Generate TOML content for a single agent config file
+ * Strip YAML frontmatter (between --- markers) from markdown content.
+ */
+export declare function stripFrontmatter(content: string): string;
+export declare function generateStandaloneAgentToml(config: GeneratedNativeAgentConfig): string;
+/**
+ * Generate TOML content for a prompt-backed OMX role agent.
  */
 export declare function generateAgentToml(agent: AgentDefinition, promptContent: string): string;
 /**
- * Install native agent config .toml files to ~/.omx/agents/
- * Returns the number of agents installed
+ * Install prompt-backed native agent config .toml files to ~/.codex/agents/
+ * Returns the number of agent files written.
  */
 export declare function installNativeAgentConfigs(pkgRoot: string, options?: {
     force?: boolean;

package/dist/agents/native-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-config.d.ts","sourceRoot":"","sources":["../../src/agents/native-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAqB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AA2GtE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAavF;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACzF,OAAO,CAAC,MAAM,CAAC,CAsCjB"}
+{"version":3,"file":"native-config.d.ts","sourceRoot":"","sources":["../../src/agents/native-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAqB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAsEtE,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;CACvD;AAsBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAcD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,0BAA0B,GACjC,MAAM,CAyBR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,MAAM,GACpB,MAAM,CAOR;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,MAAM,CAAC,CAsCjB"}

package/dist/agents/native-config.js

@@ -1,97 +1,97 @@
 /**
- * Native agent config generator for Codex CLI multi-agent roles
- * Generates per-agent .toml files at ~/.omx/agents/<name>.toml
+ * Native agent config generators for Codex CLI.
+ * Writes standalone TOML files under ~/.codex/agents/ or ./.codex/agents/.
  */
-import { existsSync } from 'fs';
-import { mkdir, readFile, writeFile } from 'fs/promises';
-import { join } from 'path';
-import { AGENT_DEFINITIONS } from './definitions.js';
-import { omxAgentsConfigDir } from '../utils/paths.js';
+import { existsSync } from "fs";
+import { mkdir, readFile, writeFile } from "fs/promises";
+import { join } from "path";
+import { AGENT_DEFINITIONS } from "./definitions.js";
+import { codexAgentsDir } from "../utils/paths.js";
 const POSTURE_OVERLAYS = {
-    'frontier-orchestrator': [
-        '<posture_overlay>',
-        '',
-        'You are operating in the frontier-orchestrator posture.',
-        '- Prioritize intent classification before implementation.',
-        '- Default to delegation and orchestration when specialists exist.',
-        '- Treat the first decision as a routing problem: research vs planning vs implementation vs verification.',
-        '- Challenge flawed user assumptions concisely before execution when the design is likely to cause avoidable problems.',
-        '- Preserve explicit executor handoff boundaries: do not absorb deep implementation work when a specialized executor is more appropriate.',
-        '',
-        '</posture_overlay>',
-    ].join('\n'),
-    'deep-worker': [
-        '<posture_overlay>',
-        '',
-        'You are operating in the deep-worker posture.',
-        '- Once the task is clearly implementation-oriented, bias toward direct execution and end-to-end completion.',
-        '- Explore first, then implement minimal changes that match existing patterns.',
-        '- Keep verification strict: diagnostics, tests, and build evidence are mandatory before claiming completion.',
-        '- Escalate only after materially different approaches fail or when architecture tradeoffs exceed local implementation scope.',
-        '',
-        '</posture_overlay>',
-    ].join('\n'),
-    'fast-lane': [
-        '<posture_overlay>',
-        '',
-        'You are operating in the fast-lane posture.',
-        '- Optimize for fast triage, search, lightweight synthesis, and narrow routing decisions.',
-        '- Do not start deep implementation unless the task is tightly bounded and obvious.',
-        '- If the task expands beyond quick classification or lightweight execution, escalate to a frontier-orchestrator or deep-worker role.',
-        '- Keep responses concise, scope-aware, and conservative under ambiguity.',
-        '',
-        '</posture_overlay>',
-    ].join('\n'),
+    "frontier-orchestrator": [
+        "<posture_overlay>",
+        "",
+        "You are operating in the frontier-orchestrator posture.",
+        "- Prioritize intent classification before implementation.",
+        "- Default to delegation and orchestration when specialists exist.",
+        "- Treat the first decision as a routing problem: research vs planning vs implementation vs verification.",
+        "- Challenge flawed user assumptions concisely before execution when the design is likely to cause avoidable problems.",
+        "- Preserve explicit executor handoff boundaries: do not absorb deep implementation work when a specialized executor is more appropriate.",
+        "",
+        "</posture_overlay>",
+    ].join("\n"),
+    "deep-worker": [
+        "<posture_overlay>",
+        "",
+        "You are operating in the deep-worker posture.",
+        "- Once the task is clearly implementation-oriented, bias toward direct execution and end-to-end completion.",
+        "- Explore first, then implement minimal changes that match existing patterns.",
+        "- Keep verification strict: diagnostics, tests, and build evidence are mandatory before claiming completion.",
+        "- Escalate only after materially different approaches fail or when architecture tradeoffs exceed local implementation scope.",
+        "",
+        "</posture_overlay>",
+    ].join("\n"),
+    "fast-lane": [
+        "<posture_overlay>",
+        "",
+        "You are operating in the fast-lane posture.",
+        "- Optimize for fast triage, search, lightweight synthesis, and narrow routing decisions.",
+        "- Do not start deep implementation unless the task is tightly bounded and obvious.",
+        "- If the task expands beyond quick classification or lightweight execution, escalate to a frontier-orchestrator or deep-worker role.",
+        "- Keep responses concise, scope-aware, and conservative under ambiguity.",
+        "",
+        "</posture_overlay>",
+    ].join("\n"),
 };
 const MODEL_CLASS_OVERLAYS = {
     frontier: [
-        '<model_class_guidance>',
-        '',
-        'This role is tuned for frontier-class models.',
-        '- Use the model\'s steerability for coordination, tradeoff reasoning, and precise delegation.',
-        '- Favor clean routing decisions over impulsive implementation.',
-        '',
-        '</model_class_guidance>',
-    ].join('\n'),
+        "<model_class_guidance>",
+        "",
+        "This role is tuned for frontier-class models.",
+        "- Use the model's steerability for coordination, tradeoff reasoning, and precise delegation.",
+        "- Favor clean routing decisions over impulsive implementation.",
+        "",
+        "</model_class_guidance>",
+    ].join("\n"),
     standard: [
-        '<model_class_guidance>',
-        '',
-        'This role is tuned for standard-capability models.',
-        '- Balance autonomy with clear boundaries.',
-        '- Prefer explicit verification and narrow scope control over speculative reasoning.',
-        '',
-        '</model_class_guidance>',
-    ].join('\n'),
+        "<model_class_guidance>",
+        "",
+        "This role is tuned for standard-capability models.",
+        "- Balance autonomy with clear boundaries.",
+        "- Prefer explicit verification and narrow scope control over speculative reasoning.",
+        "",
+        "</model_class_guidance>",
+    ].join("\n"),
     fast: [
-        '<model_class_guidance>',
-        '',
-        'This role is tuned for fast/low-latency models.',
-        '- Prefer quick search, synthesis, and routing over prolonged reasoning.',
-        '- Escalate rather than bluff when deeper work is required.',
-        '',
-        '</model_class_guidance>',
-    ].join('\n'),
+        "<model_class_guidance>",
+        "",
+        "This role is tuned for fast/low-latency models.",
+        "- Prefer quick search, synthesis, and routing over prolonged reasoning.",
+        "- Escalate rather than bluff when deeper work is required.",
+        "",
+        "</model_class_guidance>",
+    ].join("\n"),
 };
 function buildPromptInstructions(agent, promptContent) {
     const instructions = stripFrontmatter(promptContent);
     return [
         instructions,
-        '',
+        "",
         POSTURE_OVERLAYS[agent.posture],
-        '',
+        "",
         MODEL_CLASS_OVERLAYS[agent.modelClass],
-        '',
-        `## OMX Agent Metadata`,
+        "",
+        "## OMX Agent Metadata",
         `- role: ${agent.name}`,
         `- posture: ${agent.posture}`,
         `- model_class: ${agent.modelClass}`,
         `- routing_role: ${agent.routingRole}`,
-    ].join('\n');
+    ].join("\n");
 }
 /**
- * Strip YAML frontmatter (between --- markers) from markdown content
+ * Strip YAML frontmatter (between --- markers) from markdown content.
  */
-function stripFrontmatter(content) {
+export function stripFrontmatter(content) {
     const match = content.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
     if (match) {
         return content.slice(match[0].length).trim();
@@ -103,37 +103,54 @@ function stripFrontmatter(content) {
  * TOML """ strings only need to escape sequences of 3+ consecutive quotes.
  */
 function escapeTomlMultiline(s) {
-    // Replace sequences of 3+ double quotes with escaped versions
-    return s.replace(/"{3,}/g, (match) => match.split('').join('\\'));
+    return s.replace(/"{3,}/g, (match) => match.split("").join("\\"));
+}
+function escapeTomlBasicString(s) {
+    return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+export function generateStandaloneAgentToml(config) {
+    const lines = [
+        `# oh-my-codex agent: ${config.name}`,
+        `name = "${escapeTomlBasicString(config.name)}"`,
+        `description = "${escapeTomlBasicString(config.description)}"`,
+    ];
+    if (config.model) {
+        lines.push(`model = "${escapeTomlBasicString(config.model)}"`);
+    }
+    if (config.reasoningEffort) {
+        lines.push(`model_reasoning_effort = "${config.reasoningEffort}"`);
+    }
+    if (typeof config.developerInstructions === "string" &&
+        config.developerInstructions.trim().length > 0) {
+        const escapedInstructions = escapeTomlMultiline(config.developerInstructions);
+        lines.push('developer_instructions = """', escapedInstructions, '"""');
+    }
+    lines.push("");
+    return lines.join("\n");
 }
 /**
- * Generate TOML content for a single agent config file
+ * Generate TOML content for a prompt-backed OMX role agent.
  */
 export function generateAgentToml(agent, promptContent) {
-    const instructions = buildPromptInstructions(agent, promptContent);
-    const effort = agent.reasoningEffort;
-    const escaped = escapeTomlMultiline(instructions);
-    return [
-        `# oh-my-codex agent: ${agent.name}`,
-        `model_reasoning_effort = "${effort}"`,
-        `developer_instructions = """`,
-        escaped,
-        `"""`,
-        '',
-    ].join('\n');
+    return generateStandaloneAgentToml({
+        name: agent.name,
+        description: agent.description,
+        developerInstructions: buildPromptInstructions(agent, promptContent),
+        reasoningEffort: agent.reasoningEffort,
+    });
 }
 /**
- * Install native agent config .toml files to ~/.omx/agents/
- * Returns the number of agents installed
+ * Install prompt-backed native agent config .toml files to ~/.codex/agents/
+ * Returns the number of agent files written.
  */
 export async function installNativeAgentConfigs(pkgRoot, options = {}) {
-    const { force = false, dryRun = false, verbose = false, agentsDir = omxAgentsConfigDir(), } = options;
+    const { force = false, dryRun = false, verbose = false, agentsDir = codexAgentsDir(), } = options;
     if (!dryRun) {
         await mkdir(agentsDir, { recursive: true });
     }
     let count = 0;
     for (const [name, agent] of Object.entries(AGENT_DEFINITIONS)) {
-        const promptPath = join(pkgRoot, 'prompts', `${name}.md`);
+        const promptPath = join(pkgRoot, "prompts", `${name}.md`);
         if (!existsSync(promptPath)) {
             if (verbose)
                 console.log(`  skip ${name} (no prompt file)`);
@@ -145,14 +162,14 @@ export async function installNativeAgentConfigs(pkgRoot, options = {}) {
                 console.log(`  skip ${name} (already exists)`);
             continue;
         }
-        const promptContent = await readFile(promptPath, 'utf-8');
+        const promptContent = await readFile(promptPath, "utf-8");
         const toml = generateAgentToml(agent, promptContent);
         if (!dryRun) {
             await writeFile(dst, toml);
         }
         if (verbose)
             console.log(`  ${name}.toml`);
-        count++;
+        count += 1;
     }
     return count;
 }

package/dist/agents/native-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-config.js","sourceRoot":"","sources":["../../src/agents/native-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"native-config.js","sourceRoot":"","sources":["../../src/agents/native-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAmB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,gBAAgB,GAA+C;IACnE,uBAAuB,EAAE;QACvB,mBAAmB;QACnB,EAAE;QACF,yDAAyD;QACzD,2DAA2D;QAC3D,mEAAmE;QACnE,0GAA0G;QAC1G,uHAAuH;QACvH,0IAA0I;QAC1I,EAAE;QACF,oBAAoB;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,aAAa,EAAE;QACb,mBAAmB;QACnB,EAAE;QACF,+CAA+C;QAC/C,6GAA6G;QAC7G,+EAA+E;QAC/E,8GAA8G;QAC9G,8HAA8H;QAC9H,EAAE;QACF,oBAAoB;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,WAAW,EAAE;QACX,mBAAmB;QACnB,EAAE;QACF,6CAA6C;QAC7C,0FAA0F;QAC1F,oFAAoF;QACpF,sIAAsI;QACtI,0EAA0E;QAC1E,EAAE;QACF,oBAAoB;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC;AAEF,MAAM,oBAAoB,GAAkD;IAC1E,QAAQ,EAAE;QACR,wBAAwB;QACxB,EAAE;QACF,+CAA+C;QAC/C,8FAA8F;QAC9F,gEAAgE;QAChE,EAAE;QACF,yBAAyB;KAC1B,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,QAAQ,EAAE;QACR,wBAAwB;QACxB,EAAE;QACF,oDAAoD;QACpD,2CAA2C;QAC3C,qFAAqF;QACrF,EAAE;QACF,yBAAyB;KAC1B,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,IAAI,EAAE;QACJ,wBAAwB;QACxB,EAAE;QACF,iDAAiD;QACjD,yEAAyE;QACzE,4DAA4D;QAC5D,EAAE;QACF,yBAAyB;KAC1B,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC;AAUF,SAAS,uBAAuB,CAC9B,KAAsB,EACtB,aAAqB;IAErB,MAAM,YAAY,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACrD,OAAO;QACL,YAAY;QACZ,EAAE;QACF,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC;QAC/B,EAAE;QACF,oBAAoB,CAAC,KAAK,CAAC,UAAU,CAAC;QACtC,EAAE;QACF,uBAAuB;QACvB,WAAW,KAAK,CAAC,IAAI,EAAE;QACvB,cAAc,KAAK,CAAC,OAAO,EAAE;QAC7B,kBAAkB,KAAK,CAAC,UAAU,EAAE;QACpC,mBAAmB,KAAK,CAAC,WAAW,EAAE;KACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC/D,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,CAAS;IACpC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,qBAAqB,CAAC,CAAS;IACtC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAAkC;IAElC,MAAM,KAAK,GAAG;QACZ,wBAAwB,MAAM,CAAC,IAAI,EAAE;QACrC,WAAW,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;QAChD,kBAAkB,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG;KAC/D,CAAC;IAEF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,YAAY,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,eAAe,GAAG,CAAC,CAAC;IACrE,CAAC;IACD,IACE,OAAO,MAAM,CAAC,qBAAqB,KAAK,QAAQ;QAChD,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAC9C,CAAC;QACD,MAAM,mBAAmB,GAAG,mBAAmB,CAC7C,MAAM,CAAC,qBAAqB,CAC7B,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,8BAA8B,EAAE,mBAAmB,EAAE,KAAK,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAsB,EACtB,aAAqB;IAErB,OAAO,2BAA2B,CAAC;QACjC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,qBAAqB,EAAE,uBAAuB,CAAC,KAAK,EAAE,aAAa,CAAC;QACpE,eAAe,EAAE,KAAK,CAAC,eAAe;KACvC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAe,EACf,UAKI,EAAE;IAEN,MAAM,EACJ,KAAK,GAAG,KAAK,EACb,MAAM,GAAG,KAAK,EACd,OAAO,GAAG,KAAK,EACf,SAAS,GAAG,cAAc,EAAE,GAC7B,GAAG,OAAO,CAAC;IAEZ,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,IAAI,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,mBAAmB,CAAC,CAAC;YAC5D,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,mBAAmB,CAAC,CAAC;YAC5D,SAAS;QACX,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAErD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC;QAC3C,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/agents/skill-bridge.d.ts

@@ -0,0 +1,20 @@
+export interface SkillBridgeAgentConfig {
+    name: string;
+    description: string;
+    skillRef: string;
+    model?: string;
+    reasoningEffort?: 'low' | 'medium' | 'high' | 'xhigh';
+}
+export interface SkillBridgeAgentRecord {
+    name: string;
+    description: string;
+    skillRef: string;
+    scope: 'project' | 'user';
+    path: string;
+    model?: string;
+    reasoningEffort?: 'low' | 'medium' | 'high' | 'xhigh';
+}
+export declare function generateSkillBridgeAgentToml(config: SkillBridgeAgentConfig): string;
+export declare function listInstalledSkillBridgeAgents(projectRoot?: string): Promise<SkillBridgeAgentRecord[]>;
+export declare function buildSkillBridgeResolutionGuidance(projectRoot?: string): Promise<string>;
+//# sourceMappingURL=skill-bridge.d.ts.map

package/dist/agents/skill-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-bridge.d.ts","sourceRoot":"","sources":["../../src/agents/skill-bridge.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;CACvD;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;CACvD;AAoBD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAgBnF;AA+CD,wBAAsB,8BAA8B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAc5G;AAoCD,wBAAsB,kCAAkC,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiC9F"}

package/dist/agents/skill-bridge.js

@@ -0,0 +1,150 @@
+import TOML from '@iarna/toml';
+import { existsSync } from 'node:fs';
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { codexAgentsDir, listInstalledSkillDirectories, projectCodexAgentsDir, projectSkillsDir, userSkillsDir, } from '../utils/paths.js';
+function escapeTomlBasicString(s) {
+    return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+function normalizeNonEmptyString(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function normalizeReasoning(value) {
+    const normalized = normalizeNonEmptyString(value)?.toLowerCase();
+    if (normalized === 'low' || normalized === 'medium' || normalized === 'high' || normalized === 'xhigh') {
+        return normalized;
+    }
+    return undefined;
+}
+export function generateSkillBridgeAgentToml(config) {
+    const lines = [
+        `# oh-my-codex skill bridge agent: ${config.name}`,
+        `name = "${escapeTomlBasicString(config.name)}"`,
+        `description = "${escapeTomlBasicString(config.description)}"`,
+    ];
+    if (config.model) {
+        lines.push(`model = "${escapeTomlBasicString(config.model)}"`);
+    }
+    if (config.reasoningEffort) {
+        lines.push(`model_reasoning_effort = "${config.reasoningEffort}"`);
+    }
+    lines.push(`skill_ref = "${escapeTomlBasicString(config.skillRef)}"`, '');
+    return lines.join('\n');
+}
+function parseSkillBridgeAgentRecord(content, path, scope) {
+    try {
+        const parsed = TOML.parse(content);
+        const skillRef = normalizeNonEmptyString(parsed.skill_ref);
+        const name = normalizeNonEmptyString(parsed.name);
+        const description = normalizeNonEmptyString(parsed.description);
+        if (!skillRef || !name || !description)
+            return null;
+        return {
+            name,
+            description,
+            skillRef,
+            scope,
+            path,
+            model: normalizeNonEmptyString(parsed.model),
+            reasoningEffort: normalizeReasoning(parsed.model_reasoning_effort),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function readSkillBridgeAgentsFromDir(dir, scope) {
+    if (!existsSync(dir))
+        return [];
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    const bridges = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.toml'))
+            continue;
+        const path = join(dir, entry.name);
+        const parsed = parseSkillBridgeAgentRecord(await readFile(path, 'utf-8'), path, scope);
+        if (parsed)
+            bridges.push(parsed);
+    }
+    return bridges.sort((a, b) => a.name.localeCompare(b.name));
+}
+export async function listInstalledSkillBridgeAgents(projectRoot) {
+    const [projectAgents, userAgents] = await Promise.all([
+        readSkillBridgeAgentsFromDir(projectCodexAgentsDir(projectRoot), 'project'),
+        readSkillBridgeAgentsFromDir(codexAgentsDir(), 'user'),
+    ]);
+    const deduped = [];
+    const seenNames = new Set();
+    for (const item of [...projectAgents, ...userAgents]) {
+        if (seenNames.has(item.name))
+            continue;
+        seenNames.add(item.name);
+        deduped.push(item);
+    }
+    return deduped;
+}
+function listNames(items, limit = 8) {
+    if (items.length === 0)
+        return '- none';
+    const visible = items.slice(0, limit).map((item) => `- \`${item}\``);
+    if (items.length > limit)
+        visible.push(`- ...and ${items.length - limit} more`);
+    return visible.join('\n');
+}
+function buildSkillResolutionOrder(skillsByName, projectRoot) {
+    const projectScoped = [...skillsByName.values()].filter((item) => item.scope === 'project');
+    const userScoped = [...skillsByName.values()].filter((item) => item.scope === 'user');
+    const lines = [
+        'Resolution order for a referenced skill:',
+        `1. \`${userSkillsDir()}/<skill>/SKILL.md\` (primary Codex skills path)`,
+        `2. \`${projectSkillsDir(projectRoot)}/<skill>/SKILL.md\` (legacy project fallback)`,
+        '3. `~/.agents/skills/<skill>/SKILL.md` (legacy compatibility fallback)',
+    ];
+    if (userScoped.length > 0 || projectScoped.length > 0) {
+        lines.push('');
+        if (userScoped.length > 0) {
+            lines.push(`Codex-installed skills (primary):\n${listNames(userScoped.map((item) => item.name))}`);
+        }
+        if (projectScoped.length > 0) {
+            lines.push(`Legacy project skills fallback:\n${listNames(projectScoped.map((item) => item.name))}`);
+        }
+    }
+    return lines;
+}
+export async function buildSkillBridgeResolutionGuidance(projectRoot) {
+    const bridges = await listInstalledSkillBridgeAgents(projectRoot);
+    if (bridges.length === 0)
+        return '';
+    const installedSkills = await listInstalledSkillDirectories(projectRoot);
+    const skillsByName = new Map(installedSkills.map((item) => [item.name, item]));
+    const bridgeLines = bridges.map((bridge) => {
+        const primaryCodexSkillPath = join(userSkillsDir(), bridge.skillRef, 'SKILL.md');
+        const legacyProjectSkillPath = join(projectSkillsDir(projectRoot), bridge.skillRef, 'SKILL.md');
+        const legacyUserSkillPath = join(process.env.HOME || '~', '.agents', 'skills', bridge.skillRef, 'SKILL.md');
+        const suffix = existsSync(primaryCodexSkillPath)
+            ? ' -> Codex skills primary'
+            : existsSync(legacyProjectSkillPath)
+                ? ' -> legacy project fallback'
+                : existsSync(legacyUserSkillPath)
+                    ? ' -> legacy user fallback'
+                    : skillsByName.get(bridge.skillRef)
+                        ? ` -> ${skillsByName.get(bridge.skillRef)?.scope} skill`
+                        : ' -> unresolved skill (keep fallback resolution order)';
+        return `- \`${bridge.name}\` => \`${bridge.skillRef}\`${suffix}`;
+    });
+    return [
+        '**Native Skill Bridge:**',
+        'Some lightweight native agent TOMLs declare `skill_ref` instead of embedding skill markdown.',
+        'When the active native agent includes `skill_ref`, resolve that reference at runtime and follow the installed SKILL.md instructions from disk.',
+        'Do not expect long `developer_instructions` blocks inside skill-bridge TOMLs.',
+        '',
+        'Installed skill bridge agents:',
+        ...bridgeLines,
+        '',
+        ...buildSkillResolutionOrder(skillsByName, projectRoot),
+    ].join('\n');
+}
+//# sourceMappingURL=skill-bridge.js.map

package/dist/agents/skill-bridge.js.map

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