oh-my-codex-pennix 0.18.13

package/dist/utils/__tests__/sleep-resource.test.js

@@ -0,0 +1,39 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { sleep } from '../sleep.js';
+describe('sleep resource cleanup', () => {
+    it('removes abort listeners after timer resolution to avoid resource leaks', async () => {
+        const controller = new AbortController();
+        let adds = 0;
+        let removes = 0;
+        const originalAdd = controller.signal.addEventListener.bind(controller.signal);
+        const originalRemove = controller.signal.removeEventListener.bind(controller.signal);
+        controller.signal.addEventListener = ((...args) => {
+            if (args[0] === 'abort')
+                adds += 1;
+            return originalAdd(...args);
+        });
+        controller.signal.removeEventListener = ((...args) => {
+            if (args[0] === 'abort')
+                removes += 1;
+            return originalRemove(...args);
+        });
+        await sleep(1, controller.signal);
+        assert.equal(adds, 1);
+        assert.equal(removes, 1);
+    });
+    it('rejects already-aborted signals without registering resource-leaking listeners', async () => {
+        const controller = new AbortController();
+        controller.abort(new Error('stop'));
+        let adds = 0;
+        const originalAdd = controller.signal.addEventListener.bind(controller.signal);
+        controller.signal.addEventListener = ((...args) => {
+            if (args[0] === 'abort')
+                adds += 1;
+            return originalAdd(...args);
+        });
+        await assert.rejects(() => sleep(100, controller.signal), /stop/);
+        assert.equal(adds, 0);
+    });
+});
+//# sourceMappingURL=sleep-resource.test.js.map

package/dist/utils/__tests__/sleep-resource.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep-resource.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/sleep-resource.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/E,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAErF,UAAU,CAAC,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC,GAAG,IAAiD,EAAE,EAAE;YAC7F,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO;gBAAE,IAAI,IAAI,CAAC,CAAC;YACnC,OAAO,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9B,CAAC,CAAoC,CAAC;QACtC,UAAU,CAAC,MAAM,CAAC,mBAAmB,GAAG,CAAC,CAAC,GAAG,IAAoD,EAAE,EAAE;YACnG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO;gBAAE,OAAO,IAAI,CAAC,CAAC;YACtC,OAAO,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;QACjC,CAAC,CAAuC,CAAC;QAEzC,MAAM,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAElC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;QAC9F,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACpC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/E,UAAU,CAAC,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC,GAAG,IAAiD,EAAE,EAAE;YAC7F,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO;gBAAE,IAAI,IAAI,CAAC,CAAC;YACnC,OAAO,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9B,CAAC,CAAoC,CAAC;QAEtC,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/__tests__/version.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=version.test.d.ts.map

package/dist/utils/__tests__/version.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/version.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/version.test.js

@@ -0,0 +1,78 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { resolveOmxDisplayVersionSync } from '../version.js';
+async function withVersionFixture(run) {
+    const root = await mkdtemp(join(tmpdir(), 'omx-version-fixture-'));
+    try {
+        await mkdir(join(root, 'pkg'), { recursive: true });
+        await mkdir(join(root, 'state'), { recursive: true });
+        await writeFile(join(root, 'pkg', 'package.json'), JSON.stringify({ version: '0.18.8' }, null, 2));
+        await run({ packageRoot: join(root, 'pkg'), stampPath: join(root, 'state', 'install-state.json') });
+    }
+    finally {
+        await rm(root, { recursive: true, force: true });
+    }
+}
+describe('resolveOmxDisplayVersionSync', () => {
+    it('returns a plain release version when no current dev install stamp is present', async () => {
+        await withVersionFixture(({ packageRoot, stampPath }) => {
+            assert.equal(resolveOmxDisplayVersionSync({ packageRoot, stampPath }), 'v0.18.8');
+        });
+    });
+    it('adds dev revision from the current dev install stamp', async () => {
+        await withVersionFixture(async ({ packageRoot, stampPath }) => {
+            await writeFile(stampPath, JSON.stringify({
+                installed_version: '0.18.8',
+                setup_completed_version: '0.18.8',
+                install_channel: 'dev',
+                install_source: 'github:Yeachan-Heo/oh-my-codex#dev',
+                install_revision: 'abcdef1234567890',
+                updated_at: '2026-06-02T00:00:00.000Z',
+            }, null, 2));
+            assert.equal(resolveOmxDisplayVersionSync({ packageRoot, stampPath }), 'v0.18.8-dev-abcdef123456');
+        });
+    });
+    it('uses a dev base version from the install stamp when package.json lags the release baseline', async () => {
+        await withVersionFixture(async ({ packageRoot, stampPath }) => {
+            await writeFile(stampPath, JSON.stringify({
+                installed_version: '0.18.8',
+                setup_completed_version: '0.18.8',
+                dev_base_version: '0.18.9',
+                install_channel: 'dev',
+                install_source: 'github:Yeachan-Heo/oh-my-codex#dev',
+                install_revision: 'feedfacecafebeef',
+                updated_at: '2026-06-09T00:00:00.000Z',
+            }, null, 2));
+            assert.equal(resolveOmxDisplayVersionSync({ packageRoot, stampPath }), 'v0.18.9-dev-feedfacecafe');
+        });
+    });
+    it('does not apply stale dev stamp metadata to a different package version', async () => {
+        await withVersionFixture(async ({ packageRoot, stampPath }) => {
+            await writeFile(stampPath, JSON.stringify({
+                installed_version: '0.18.7',
+                setup_completed_version: '0.18.7',
+                install_channel: 'dev',
+                install_revision: 'abcdef123456',
+                updated_at: '2026-06-02T00:00:00.000Z',
+            }, null, 2));
+            assert.equal(resolveOmxDisplayVersionSync({ packageRoot, stampPath }), 'v0.18.8');
+        });
+    });
+    it('does not let stale dev_base_version metadata make a mismatched stamp current', async () => {
+        await withVersionFixture(async ({ packageRoot, stampPath }) => {
+            await writeFile(stampPath, JSON.stringify({
+                installed_version: '0.18.7',
+                setup_completed_version: '0.18.7',
+                dev_base_version: '0.18.11',
+                install_channel: 'dev',
+                install_revision: 'feedfacecafebeef',
+                updated_at: '2026-06-09T00:00:00.000Z',
+            }, null, 2));
+            assert.equal(resolveOmxDisplayVersionSync({ packageRoot, stampPath }), 'v0.18.8');
+        });
+    });
+});
+//# sourceMappingURL=version.test.js.map

package/dist/utils/__tests__/version.test.js.map

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

package/dist/utils/agents-md.d.ts

@@ -0,0 +1,10 @@
+export declare const OMX_GENERATED_AGENTS_MARKER = "<!-- omx:generated:agents-md -->";
+export declare const OMX_MANAGED_AGENTS_START_MARKER = "<!-- OMX:AGENTS:START -->";
+export declare const OMX_MANAGED_AGENTS_END_MARKER = "<!-- OMX:AGENTS:END -->";
+export declare const OMX_AGENTS_CONTRACT_HEADING = "# oh-my-codex - Intelligent Multi-Agent Orchestration";
+export declare function isOmxGeneratedAgentsMd(content: string): boolean;
+export declare function hasOmxManagedAgentsSections(content: string): boolean;
+export declare function hasOmxAgentsContract(content: string): boolean;
+export declare function upsertManagedAgentsBlock(existingContent: string, managedContent: string): string;
+export declare function addGeneratedAgentsMarker(content: string): string;
+//# sourceMappingURL=agents-md.d.ts.map

package/dist/utils/agents-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../src/utils/agents-md.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,2BAA2B,qCAAqC,CAAA;AAC7E,eAAO,MAAM,+BAA+B,8BAA8B,CAAA;AAC1E,eAAO,MAAM,6BAA6B,4BAA4B,CAAA;AACtE,eAAO,MAAM,2BAA2B,0DACiB,CAAA;AAQzD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQpE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAY7D;AAQD,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,MAAM,CAuBR;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAyBhE"}

package/dist/utils/agents-md.js

@@ -0,0 +1,76 @@
+import { OMX_MODELS_END_MARKER, OMX_MODELS_START_MARKER, } from './agents-model-table.js';
+export const OMX_GENERATED_AGENTS_MARKER = '<!-- omx:generated:agents-md -->';
+export const OMX_MANAGED_AGENTS_START_MARKER = '<!-- OMX:AGENTS:START -->';
+export const OMX_MANAGED_AGENTS_END_MARKER = '<!-- OMX:AGENTS:END -->';
+export const OMX_AGENTS_CONTRACT_HEADING = '# oh-my-codex - Intelligent Multi-Agent Orchestration';
+const OMX_AGENTS_CONTRACT_REQUIRED_TEXT = [
+    OMX_GENERATED_AGENTS_MARKER,
+    OMX_AGENTS_CONTRACT_HEADING,
+    'AGENTS.md is the top-level operating contract for the workspace.',
+];
+const AUTONOMY_DIRECTIVE_END_MARKER = '<!-- END AUTONOMY DIRECTIVE -->';
+export function isOmxGeneratedAgentsMd(content) {
+    return content.includes(OMX_GENERATED_AGENTS_MARKER);
+}
+export function hasOmxManagedAgentsSections(content) {
+    return (isOmxGeneratedAgentsMd(content) ||
+        (content.includes(OMX_MANAGED_AGENTS_START_MARKER) &&
+            content.includes(OMX_MANAGED_AGENTS_END_MARKER)) ||
+        (content.includes(OMX_MODELS_START_MARKER) &&
+            content.includes(OMX_MODELS_END_MARKER)));
+}
+export function hasOmxAgentsContract(content) {
+    if (candidateHasOmxAgentsContract(content))
+        return true;
+    const startIndex = content.indexOf(OMX_MANAGED_AGENTS_START_MARKER);
+    const endIndex = content.indexOf(OMX_MANAGED_AGENTS_END_MARKER);
+    if (startIndex === -1 || endIndex <= startIndex)
+        return false;
+    const managedBlock = content.slice(startIndex + OMX_MANAGED_AGENTS_START_MARKER.length, endIndex);
+    return candidateHasOmxAgentsContract(managedBlock);
+}
+function candidateHasOmxAgentsContract(content) {
+    return OMX_AGENTS_CONTRACT_REQUIRED_TEXT.every((text) => content.includes(text));
+}
+export function upsertManagedAgentsBlock(existingContent, managedContent) {
+    const normalizedExisting = existingContent.endsWith('\n')
+        ? existingContent
+        : `${existingContent}\n`;
+    const normalizedManaged = managedContent.endsWith('\n')
+        ? managedContent
+        : `${managedContent}\n`;
+    const block = [
+        OMX_MANAGED_AGENTS_START_MARKER,
+        normalizedManaged.trimEnd(),
+        OMX_MANAGED_AGENTS_END_MARKER,
+    ].join('\n');
+    const startIndex = normalizedExisting.indexOf(OMX_MANAGED_AGENTS_START_MARKER);
+    const endIndex = normalizedExisting.indexOf(OMX_MANAGED_AGENTS_END_MARKER);
+    if (startIndex >= 0 && endIndex > startIndex) {
+        const replaceEnd = endIndex + OMX_MANAGED_AGENTS_END_MARKER.length;
+        const next = `${normalizedExisting.slice(0, startIndex)}${block}${normalizedExisting.slice(replaceEnd)}`;
+        return next.endsWith('\n') ? next : `${next}\n`;
+    }
+    return `${normalizedExisting.trimEnd()}\n\n${block}\n`;
+}
+export function addGeneratedAgentsMarker(content) {
+    if (content.includes(OMX_GENERATED_AGENTS_MARKER))
+        return content;
+    const autonomyDirectiveEnd = content.indexOf(AUTONOMY_DIRECTIVE_END_MARKER);
+    if (autonomyDirectiveEnd >= 0) {
+        const insertAt = autonomyDirectiveEnd + AUTONOMY_DIRECTIVE_END_MARKER.length;
+        const hasImmediateNewline = content[insertAt] === '\n';
+        const insertionPoint = hasImmediateNewline ? insertAt + 1 : insertAt;
+        return (content.slice(0, insertionPoint) +
+            `${OMX_GENERATED_AGENTS_MARKER}\n` +
+            content.slice(insertionPoint));
+    }
+    const firstNewline = content.indexOf('\n');
+    if (firstNewline === -1) {
+        return `${content}\n${OMX_GENERATED_AGENTS_MARKER}\n`;
+    }
+    return (content.slice(0, firstNewline + 1) +
+        `${OMX_GENERATED_AGENTS_MARKER}\n` +
+        content.slice(firstNewline + 1));
+}
+//# sourceMappingURL=agents-md.js.map

package/dist/utils/agents-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../../src/utils/agents-md.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,yBAAyB,CAAA;AAEhC,MAAM,CAAC,MAAM,2BAA2B,GAAG,kCAAkC,CAAA;AAC7E,MAAM,CAAC,MAAM,+BAA+B,GAAG,2BAA2B,CAAA;AAC1E,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAA;AACtE,MAAM,CAAC,MAAM,2BAA2B,GACtC,uDAAuD,CAAA;AACzD,MAAM,iCAAiC,GAAG;IACxC,2BAA2B;IAC3B,2BAA2B;IAC3B,kEAAkE;CAC1D,CAAA;AACV,MAAM,6BAA6B,GAAG,iCAAiC,CAAA;AAEvE,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,OAAO,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAe;IACzD,OAAO,CACL,sBAAsB,CAAC,OAAO,CAAC;QAC/B,CAAC,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YAChD,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC;QAClD,CAAC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACxC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAC3C,CAAA;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,IAAI,6BAA6B,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IAEvD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAA;IACnE,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAA;IAC/D,IAAI,UAAU,KAAK,CAAC,CAAC,IAAI,QAAQ,IAAI,UAAU;QAAE,OAAO,KAAK,CAAA;IAE7D,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAChC,UAAU,GAAG,+BAA+B,CAAC,MAAM,EACnD,QAAQ,CACT,CAAA;IACD,OAAO,6BAA6B,CAAC,YAAY,CAAC,CAAA;AACpD,CAAC;AAED,SAAS,6BAA6B,CAAC,OAAe;IACpD,OAAO,iCAAiC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CACtD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CACvB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,eAAuB,EACvB,cAAsB;IAEtB,MAAM,kBAAkB,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC;QACvD,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,GAAG,eAAe,IAAI,CAAA;IAC1B,MAAM,iBAAiB,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrD,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,GAAG,cAAc,IAAI,CAAA;IACzB,MAAM,KAAK,GAAG;QACZ,+BAA+B;QAC/B,iBAAiB,CAAC,OAAO,EAAE;QAC3B,6BAA6B;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEZ,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAA;IAC9E,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAA;IAE1E,IAAI,UAAU,IAAI,CAAC,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,QAAQ,GAAG,6BAA6B,CAAC,MAAM,CAAA;QAClE,MAAM,IAAI,GAAG,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAA;QACxG,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAA;IACjD,CAAC;IAED,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,IAAI,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAAE,OAAO,OAAO,CAAA;IAEjE,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAA;IAC3E,IAAI,oBAAoB,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,oBAAoB,GAAG,6BAA6B,CAAC,MAAM,CAAA;QAC5E,MAAM,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAA;QACtD,MAAM,cAAc,GAAG,mBAAmB,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;QACpE,OAAO,CACL,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC;YAChC,GAAG,2BAA2B,IAAI;YAClC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAC9B,CAAA;IACH,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,OAAO,KAAK,2BAA2B,IAAI,CAAA;IACvD,CAAC;IAED,OAAO,CACL,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC;QAClC,GAAG,2BAA2B,IAAI;QAClC,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAChC,CAAA;AACH,CAAC"}

package/dist/utils/agents-model-table.d.ts

@@ -0,0 +1,16 @@
+import { type AgentDefinition } from '../agents/definitions.js';
+export declare const OMX_MODELS_START_MARKER = "<!-- OMX:MODELS:START -->";
+export declare const OMX_MODELS_END_MARKER = "<!-- OMX:MODELS:END -->";
+export interface AgentsModelTableContext {
+    frontierModel: string;
+    sparkModel: string;
+    subagentDefaultModel: string;
+}
+export declare function resolveAgentsModelTableContext(configTomlContent: string, options?: {
+    codexHomeOverride?: string;
+    env?: NodeJS.ProcessEnv;
+}): AgentsModelTableContext;
+export declare function buildAgentsModelTable(context: AgentsModelTableContext, definitions?: Record<string, AgentDefinition>): string;
+export declare function renderAgentsModelTableBlock(context: AgentsModelTableContext, definitions?: Record<string, AgentDefinition>): string;
+export declare function upsertAgentsModelTable(content: string, context: AgentsModelTableContext, definitions?: Record<string, AgentDefinition>): string;
+//# sourceMappingURL=agents-model-table.d.ts.map

package/dist/utils/agents-model-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-model-table.d.ts","sourceRoot":"","sources":["../../src/utils/agents-model-table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAanF,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AACnE,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAI/D,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AA+DD,wBAAgB,8BAA8B,CAC5C,iBAAiB,EAAE,MAAM,EACzB,OAAO,GAAE;IACP,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACpB,GACL,uBAAuB,CAmBzB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,uBAAuB,EAChC,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAqB,GAC/D,MAAM,CAuCR;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,uBAAuB,EAChC,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAqB,GAC/D,MAAM,CAMR;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,uBAAuB,EAChC,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAqB,GAC/D,MAAM,CAoBR"}

package/dist/utils/agents-model-table.js

@@ -0,0 +1,102 @@
+import { AGENT_DEFINITIONS } from '../agents/definitions.js';
+import { isNativeAgentInstallableStatus } from '../agents/policy.js';
+import { tryReadCatalogManifest } from '../catalog/reader.js';
+import { getRootModelName } from '../config/generator.js';
+import { DEFAULT_FRONTIER_MODEL, DEFAULT_SPARK_MODEL, getEnvConfiguredSparkDefaultModel, getEnvConfiguredMainDefaultModel, getEnvConfiguredStandardDefaultModel, getSparkDefaultModel, } from '../config/models.js';
+export const OMX_MODELS_START_MARKER = '<!-- OMX:MODELS:START -->';
+export const OMX_MODELS_END_MARKER = '<!-- OMX:MODELS:END -->';
+const TEAM_MODEL_RESOLUTION_END = '</team_model_resolution>';
+function escapeTableCell(value) {
+    return value.replace(/\|/g, '\\|').replace(/\r?\n/g, ' ');
+}
+function formatRoleLabel(role) {
+    return role.includes('(') ? role : `\`${role}\``;
+}
+function getAgentRecommendedModel(agent, context) {
+    if (agent.exactModel) {
+        return agent.exactModel;
+    }
+    if (agent.name === 'executor') {
+        return context.frontierModel;
+    }
+    switch (agent.modelClass) {
+        case 'fast':
+            return context.sparkModel;
+        case 'frontier':
+            return context.frontierModel;
+        case 'standard':
+        default:
+            return context.subagentDefaultModel;
+    }
+}
+function getAgentUseCase(agent) {
+    return `${agent.description} (${agent.posture}, ${agent.modelClass})`;
+}
+function buildTableRow(role, model, reasoningEffort, useCase) {
+    return `| ${escapeTableCell(formatRoleLabel(role))} | ${escapeTableCell(`\`${model}\``)} | ${escapeTableCell(reasoningEffort)} | ${escapeTableCell(useCase)} |`;
+}
+function getModelTableAgents(definitions) {
+    const manifest = tryReadCatalogManifest();
+    if (!manifest)
+        return Object.values(definitions);
+    const installableAgentNames = new Set(manifest.agents
+        .filter((agent) => isNativeAgentInstallableStatus(agent.status))
+        .map((agent) => agent.name));
+    return Object.values(definitions).filter((agent) => installableAgentNames.has(agent.name));
+}
+export function resolveAgentsModelTableContext(configTomlContent, options = {}) {
+    const { codexHomeOverride, env = process.env } = options;
+    const frontierModel = getRootModelName(configTomlContent) ??
+        getEnvConfiguredMainDefaultModel(env, codexHomeOverride) ??
+        DEFAULT_FRONTIER_MODEL;
+    const sparkModel = getEnvConfiguredSparkDefaultModel(env, codexHomeOverride) ??
+        getSparkDefaultModel(codexHomeOverride) ??
+        DEFAULT_SPARK_MODEL;
+    const subagentDefaultModel = getEnvConfiguredStandardDefaultModel(env, codexHomeOverride) ??
+        frontierModel;
+    return {
+        frontierModel,
+        sparkModel,
+        subagentDefaultModel,
+    };
+}
+export function buildAgentsModelTable(context, definitions = AGENT_DEFINITIONS) {
+    const rows = [
+        buildTableRow('Frontier (leader)', context.frontierModel, 'high', 'Primary leader/orchestrator for planning, coordination, and frontier-class reasoning.'),
+        buildTableRow('Spark (explorer/fast)', context.sparkModel, 'low', 'Fast triage, explore, lightweight synthesis, and low-latency routing.'),
+        buildTableRow('Standard (subagent default)', context.subagentDefaultModel, 'high', 'Default standard-capability model for installable specialists and secondary worker lanes unless a role is explicitly frontier or spark.'),
+        ...getModelTableAgents(definitions).map((agent) => buildTableRow(agent.name, getAgentRecommendedModel(agent, context), agent.reasoningEffort, getAgentUseCase(agent))),
+    ];
+    return [
+        '## Model Capability Table',
+        '',
+        'Auto-generated by `omx setup` from the current `config.toml` plus OMX model overrides.',
+        '',
+        '| Role | Model | Reasoning Effort | Use Case |',
+        '| --- | --- | --- | --- |',
+        ...rows,
+    ].join('\n');
+}
+export function renderAgentsModelTableBlock(context, definitions = AGENT_DEFINITIONS) {
+    return [
+        OMX_MODELS_START_MARKER,
+        buildAgentsModelTable(context, definitions),
+        OMX_MODELS_END_MARKER,
+    ].join('\n');
+}
+export function upsertAgentsModelTable(content, context, definitions = AGENT_DEFINITIONS) {
+    const block = renderAgentsModelTableBlock(context, definitions);
+    const startIndex = content.indexOf(OMX_MODELS_START_MARKER);
+    const endIndex = content.indexOf(OMX_MODELS_END_MARKER);
+    if (startIndex >= 0 && endIndex > startIndex) {
+        const replaceEnd = endIndex + OMX_MODELS_END_MARKER.length;
+        return `${content.slice(0, startIndex)}${block}${content.slice(replaceEnd)}`;
+    }
+    const insertionAnchor = `${TEAM_MODEL_RESOLUTION_END}\n\n---`;
+    if (content.includes(insertionAnchor)) {
+        return content.replace(insertionAnchor, `${TEAM_MODEL_RESOLUTION_END}\n\n${block}\n\n---`);
+    }
+    const trailingNewline = content.endsWith('\n') ? '' : '\n';
+    return `${content}${trailingNewline}\n${block}\n`;
+}
+//# sourceMappingURL=agents-model-table.js.map

package/dist/utils/agents-model-table.js.map

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

package/dist/utils/git-layout.d.ts

@@ -0,0 +1,8 @@
+export interface GitLayout {
+    gitDir: string;
+    commonDir: string;
+    worktreeRoot: string;
+}
+export declare function findGitLayout(startCwd: string): GitLayout | null;
+export declare function readGitLayoutFile(baseDir: string, ...parts: string[]): string | null;
+//# sourceMappingURL=git-layout.d.ts.map

package/dist/utils/git-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-layout.d.ts","sourceRoot":"","sources":["../../src/utils/git-layout.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAyBD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CA8BhE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAEpF"}

package/dist/utils/git-layout.js

@@ -0,0 +1,58 @@
+import { readFileSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+function readTrimmedFile(path) {
+    try {
+        return readFileSync(path, 'utf-8').trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function resolveGitDirPointer(path) {
+    const raw = readTrimmedFile(path);
+    if (!raw)
+        return null;
+    const match = raw.match(/^gitdir:\s*(.+)$/i);
+    if (!match)
+        return null;
+    return resolve(dirname(path), match[1].trim());
+}
+function resolveGitCommonDir(gitDir) {
+    const commonDir = readTrimmedFile(join(gitDir, 'commondir'));
+    return commonDir ? resolve(gitDir, commonDir) : gitDir;
+}
+export function findGitLayout(startCwd) {
+    let dir = startCwd;
+    for (;;) {
+        const candidate = join(dir, '.git');
+        try {
+            const stat = statSync(candidate);
+            if (stat.isDirectory()) {
+                return {
+                    gitDir: candidate,
+                    commonDir: resolveGitCommonDir(candidate),
+                    worktreeRoot: dir,
+                };
+            }
+            if (stat.isFile()) {
+                const gitDir = resolveGitDirPointer(candidate);
+                if (gitDir) {
+                    return {
+                        gitDir,
+                        commonDir: resolveGitCommonDir(gitDir),
+                        worktreeRoot: dir,
+                    };
+                }
+            }
+        }
+        catch { /* not found, walk up */ }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+export function readGitLayoutFile(baseDir, ...parts) {
+    return readTrimmedFile(join(baseDir, ...parts));
+}
+//# sourceMappingURL=git-layout.js.map

package/dist/utils/git-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-layout.js","sourceRoot":"","sources":["../../src/utils/git-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQnD,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc;IACzC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAC7D,OAAO,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,IAAI,GAAG,GAAG,QAAQ,CAAC;IAEnB,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;YACjC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,OAAO;oBACL,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,mBAAmB,CAAC,SAAS,CAAC;oBACzC,YAAY,EAAE,GAAG;iBAClB,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBAClB,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;gBAC/C,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO;wBACL,MAAM;wBACN,SAAS,EAAE,mBAAmB,CAAC,MAAM,CAAC;wBACtC,YAAY,EAAE,GAAG;qBAClB,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,wBAAwB,CAAC,CAAC;QAEpC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,GAAG,KAAe;IACnE,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/utils/package.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Package root resolution utility
+ */
+/**
+ * Get the package root directory (where agents/, skills/, prompts/ live).
+ * Works from dist/utils/, src/utils/, and bin/.
+ */
+export declare function getPackageRoot(): string;
+//# sourceMappingURL=package.d.ts.map

package/dist/utils/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAkBvC"}

package/dist/utils/package.js

@@ -0,0 +1,31 @@
+/**
+ * Package root resolution utility
+ */
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { existsSync } from 'fs';
+/**
+ * Get the package root directory (where agents/, skills/, prompts/ live).
+ * Works from dist/utils/, src/utils/, and bin/.
+ */
+export function getPackageRoot() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        // Try going up from dist/utils/ or src/utils/
+        const candidate = join(__dirname, '..', '..');
+        if (existsSync(join(candidate, 'package.json'))) {
+            return candidate;
+        }
+        // Try going up one more (from bin/)
+        const candidate2 = join(__dirname, '..');
+        if (existsSync(join(candidate2, 'package.json'))) {
+            return candidate2;
+        }
+    }
+    catch {
+        // Fallback
+    }
+    return process.cwd();
+}
+//# sourceMappingURL=package.js.map

package/dist/utils/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,8CAA8C;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAChD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,oCAAoC;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACjD,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,WAAW;IACb,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Path utilities for oh-my-codex
+ * Resolves Codex CLI config, skills, prompts, and state directories
+ */
+/** Codex CLI home directory (~/.codex/) */
+export declare function codexHome(): string;
+export declare const OMX_ENTRY_PATH_ENV = "OMX_ENTRY_PATH";
+export declare const OMX_STARTUP_CWD_ENV = "OMX_STARTUP_CWD";
+/** Optional override root for OMX runtime files. */
+export declare function omxRoot(projectRoot?: string): string;
+export declare function canonicalizeComparablePath(rawPath: string): string;
+export declare function sameFilePath(leftPath: string, rightPath: string): boolean;
+export declare function resolveOmxEntryPath(options?: {
+    argv1?: string | null;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): string | null;
+export declare function resolveOmxCliEntryPath(options?: {
+    argv1?: string | null;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    packageRootDir?: string;
+}): string | null;
+export declare function rememberOmxLaunchContext(options?: {
+    argv1?: string | null;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): void;
+/** Codex config file path (~/.codex/config.toml) */
+export declare function codexConfigPath(): string;
+/** Codex prompts directory (~/.codex/prompts/) */
+export declare function codexPromptsDir(): string;
+/** Codex native agents directory (~/.codex/agents/) */
+export declare function codexAgentsDir(codexHomeDir?: string): string;
+/** Project-level Codex native agents directory (.codex/agents/) */
+export declare function projectCodexAgentsDir(projectRoot?: string): string;
+/** User-level skills directory ($CODEX_HOME/skills, defaults to ~/.codex/skills/) */
+export declare function userSkillsDir(): string;
+/** Project-level skills directory (.codex/skills/) */
+export declare function projectSkillsDir(projectRoot?: string): string;
+/** Historical legacy user-level skills directory (~/.agents/skills/) */
+export declare function legacyUserSkillsDir(): string;
+export type InstalledSkillScope = "project" | "user";
+export interface InstalledSkillDirectory {
+    name: string;
+    path: string;
+    scope: InstalledSkillScope;
+}
+export interface SkillRootOverlapReport {
+    canonicalDir: string;
+    legacyDir: string;
+    canonicalExists: boolean;
+    legacyExists: boolean;
+    canonicalResolvedDir: string | null;
+    legacyResolvedDir: string | null;
+    sameResolvedTarget: boolean;
+    canonicalSkillCount: number;
+    legacySkillCount: number;
+    overlappingSkillNames: string[];
+    mismatchedSkillNames: string[];
+}
+/**
+ * Installed skill directories in scope-precedence order.
+ * Project skills win over user-level skills with the same directory basename.
+ */
+export declare function listInstalledSkillDirectories(projectRoot?: string): Promise<InstalledSkillDirectory[]>;
+export declare function detectLegacySkillRootOverlap(canonicalDir?: string, legacyDir?: string): Promise<SkillRootOverlapReport>;
+/** oh-my-codex state directory (.omx/state/) */
+export declare function omxStateDir(projectRoot?: string): string;
+/** oh-my-codex project memory file (.omx/project-memory.json) */
+export declare function omxProjectMemoryPath(projectRoot?: string): string;
+/** Repository-visible project memory file used as canonical startup context. */
+export declare function canonicalProjectMemoryPath(projectRoot?: string): string;
+/** CLI-compatible repository-local project memory file (.omx/project-memory.json). */
+export declare function repoLocalProjectMemoryPath(projectRoot?: string): string;
+/**
+ * Project memory read order for startup context.
+ *
+ * Keep the repository-visible root file first for existing SessionStart compatibility,
+ * then include the CLI/MCP project-memory location before boxed OMX runtime memory.
+ */
+export declare function projectMemoryPathCandidates(projectRoot?: string): string[];
+/** First readable project memory path, preferring repository-visible canonical memory. */
+export declare function resolveProjectMemoryPath(projectRoot?: string): string | null;
+/** oh-my-codex notepad file (.omx/notepad.md) */
+export declare function omxNotepadPath(projectRoot?: string): string;
+/** oh-my-codex wiki directory (repository-root omx_wiki/) */
+export declare function omxWikiDir(projectRoot?: string): string;
+/** Legacy project-local wiki directory used before wiki pages became repository-tracked. */
+export declare function omxLegacyWikiDir(projectRoot?: string): string;
+/** oh-my-codex plans directory (.omx/plans/) */
+export declare function omxPlansDir(projectRoot?: string): string;
+/** oh-my-codex adapters directory (.omx/adapters/) */
+export declare function omxAdaptersDir(projectRoot?: string): string;
+/** oh-my-codex logs directory (.omx/logs/) */
+export declare function omxLogsDir(projectRoot?: string): string;
+/** User-scope install/update stamp path ($CODEX_HOME/.omx/install-state.json) */
+export declare function omxUserInstallStampPath(codexHomeDir?: string): string;
+/** Get the package root directory (where agents/, skills/, prompts/ live) */
+export declare function packageRoot(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

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