oh-my-codex 0.3.9 → 0.4.0

package/dist/hooks/extensibility/__tests__/example-hook-plugins.test.js

@@ -0,0 +1,153 @@
+import assert from 'node:assert/strict';
+import { readFile } from 'node:fs';
+import { access, mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, it } from 'node:test';
+import { dispatchHookEvent } from '../dispatcher.js';
+import { buildHookEvent } from '../events.js';
+const ALL_EVENTS = [
+    'session-start',
+    'session-end',
+    'session-idle',
+    'turn-complete',
+    'needs-input',
+    'pre-tool-use',
+    'post-tool-use',
+];
+const DERIVED_EVENTS = new Set(['needs-input', 'pre-tool-use', 'post-tool-use']);
+function examplePluginSource(expectedEvent) {
+    return `const EXPECTED_EVENT = ${JSON.stringify(expectedEvent)};
+
+export async function onHookEvent(event, sdk) {
+  if (event.event !== EXPECTED_EVENT) return;
+  const runId = String((event.context && event.context.run_id) || 'unknown');
+  const seenKey = 'seen_count';
+  const prev = Number((await sdk.state.read(seenKey)) ?? 0);
+  const next = Number.isFinite(prev) ? prev + 1 : 1;
+  await sdk.state.write(seenKey, next);
+  await sdk.state.write('last_event', event.event);
+  await sdk.state.write('last_source', event.source);
+  await sdk.state.write('last_run_id', runId);
+  await sdk.state.write(\`run:\${runId}\`, { event: event.event, source: event.source, at: event.timestamp });
+  await sdk.log.info('example hook fired', {
+    expected: EXPECTED_EVENT,
+    seen_count: next,
+    source: event.source,
+    run_id: runId,
+  });
+}
+`;
+}
+async function setupExamplePlugins(cwd) {
+    const hooksDir = join(cwd, '.omx', 'hooks');
+    await mkdir(hooksDir, { recursive: true });
+    for (const eventName of ALL_EVENTS) {
+        const filePath = join(hooksDir, `example-${eventName}.mjs`);
+        await writeFile(filePath, examplePluginSource(eventName), 'utf-8');
+    }
+}
+function pluginDataPath(cwd, eventName) {
+    return join(cwd, '.omx', 'state', 'hooks', 'plugins', `example-${eventName}`, 'data.json');
+}
+async function readPluginData(cwd, eventName) {
+    const path = pluginDataPath(cwd, eventName);
+    try {
+        await access(path);
+    }
+    catch {
+        return null;
+    }
+    const raw = await new Promise((resolve, reject) => {
+        readFile(path, 'utf-8', (err, data) => {
+            if (err) {
+                reject(err);
+                return;
+            }
+            resolve(data);
+        });
+    });
+    return JSON.parse(raw);
+}
+describe('example hook plugins', () => {
+    it('dispatches only the matching example plugin for a single event', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-hook-examples-'));
+        try {
+            await setupExamplePlugins(cwd);
+            const event = buildHookEvent('session-start', {
+                timestamp: '2026-01-01T00:00:00.000Z',
+                context: { run_id: 'run-session-start' },
+            });
+            const result = await dispatchHookEvent(event, {
+                cwd,
+                env: {
+                    ...process.env,
+                    OMX_HOOK_PLUGINS: '1',
+                },
+            });
+            assert.equal(result.enabled, true);
+            assert.equal(result.plugin_count, ALL_EVENTS.length);
+            assert.equal(result.results.length, ALL_EVENTS.length);
+            const matched = result.results.find((item) => item.plugin === 'example-session-start');
+            assert.ok(matched);
+            assert.equal(matched.ok, true);
+            for (const eventName of ALL_EVENTS) {
+                const data = await readPluginData(cwd, eventName);
+                if (eventName === 'session-start') {
+                    assert.ok(data);
+                    assert.equal(data.seen_count, 1);
+                    assert.equal(data.last_event, 'session-start');
+                }
+                else {
+                    assert.equal(data, null);
+                }
+            }
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+    it('covers all example plugin event types with deterministic state assertions', async () => {
+        const cwd = await mkdtemp(join(tmpdir(), 'omx-hook-examples-all-'));
+        try {
+            await setupExamplePlugins(cwd);
+            for (const eventName of ALL_EVENTS) {
+                const timestamp = `2026-01-01T00:00:00.${String(ALL_EVENTS.indexOf(eventName)).padStart(3, '0')}Z`;
+                const runId = `run-${eventName}`;
+                const envelope = buildHookEvent(eventName, {
+                    timestamp,
+                    context: { run_id: runId },
+                });
+                const result = await dispatchHookEvent(envelope, {
+                    cwd,
+                    env: {
+                        ...process.env,
+                        OMX_HOOK_PLUGINS: '1',
+                    },
+                });
+                const matched = result.results.find((item) => item.plugin === `example-${eventName}`);
+                assert.ok(matched);
+                assert.equal(matched.ok, true);
+            }
+            for (const eventName of ALL_EVENTS) {
+                const data = await readPluginData(cwd, eventName);
+                const runId = `run-${eventName}`;
+                const expectedSource = DERIVED_EVENTS.has(eventName) ? 'derived' : 'native';
+                assert.ok(data);
+                assert.equal(data.seen_count, 1);
+                assert.equal(data.last_event, eventName);
+                assert.equal(data.last_source, expectedSource);
+                assert.equal(data.last_run_id, runId);
+                assert.deepEqual(data[`run:${runId}`], {
+                    event: eventName,
+                    source: expectedSource,
+                    at: `2026-01-01T00:00:00.${String(ALL_EVENTS.indexOf(eventName)).padStart(3, '0')}Z`,
+                });
+            }
+        }
+        finally {
+            await rm(cwd, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=example-hook-plugins.test.js.map

package/dist/hooks/extensibility/__tests__/example-hook-plugins.test.js.map

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

package/dist/hooks/extensibility/dispatcher.d.ts

@@ -0,0 +1,4 @@
+import type { HookDispatchOptions, HookDispatchResult, HookEventEnvelope } from './types.js';
+export declare function isHookPluginFeatureEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function dispatchHookEvent(event: HookEventEnvelope, options?: HookDispatchOptions): Promise<HookDispatchResult>;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/hooks/extensibility/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../src/hooks/extensibility/dispatcher.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AA2KpB,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAExF;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA8E7B"}

package/dist/hooks/extensibility/dispatcher.js

@@ -0,0 +1,223 @@
+import { existsSync } from 'fs';
+import { appendFile, mkdir } from 'fs/promises';
+import { spawn } from 'child_process';
+import { join } from 'path';
+import { getPackageRoot } from '../../utils/package.js';
+import { discoverHookPlugins, isHookPluginsEnabled, resolveHookPluginTimeoutMs, validateHookPluginExport, } from './loader.js';
+const RESULT_PREFIX = '__OMX_PLUGIN_RESULT__ ';
+function hooksLogPath(cwd) {
+    const day = new Date().toISOString().slice(0, 10);
+    return join(cwd, '.omx', 'logs', `hooks-${day}.jsonl`);
+}
+async function appendHooksLog(cwd, payload) {
+    await mkdir(join(cwd, '.omx', 'logs'), { recursive: true });
+    await appendFile(hooksLogPath(cwd), `${JSON.stringify({ timestamp: new Date().toISOString(), ...payload })}\n`).catch(() => { });
+}
+function isTeamWorker(env) {
+    return typeof env.OMX_TEAM_WORKER === 'string' && env.OMX_TEAM_WORKER.trim() !== '';
+}
+async function runPluginRunner(plugin, event, options, sideEffectsEnabled) {
+    const started = Date.now();
+    const runnerPath = join(getPackageRoot(), 'dist', 'hooks', 'extensibility', 'plugin-runner.js');
+    const timeoutMs = options.timeoutMs ?? resolveHookPluginTimeoutMs(options.env);
+    if (!existsSync(runnerPath)) {
+        const duration = Date.now() - started;
+        return {
+            plugin: plugin.id,
+            path: plugin.path,
+            file: plugin.file,
+            plugin_id: plugin.id,
+            ok: false,
+            status: 'runner_error',
+            skipped: true,
+            reason: 'runner_missing',
+            durationMs: duration,
+            duration_ms: duration,
+        };
+    }
+    return await new Promise((resolve) => {
+        const child = spawn(process.execPath, [runnerPath], {
+            cwd: options.cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: {
+                ...process.env,
+                ...(options.env || {}),
+            },
+        });
+        let stdout = '';
+        let stderr = '';
+        let done = false;
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill('SIGTERM');
+        }, timeoutMs);
+        child.stdout.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on('error', (error) => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(timer);
+            const duration = Date.now() - started;
+            resolve({
+                plugin: plugin.id,
+                path: plugin.path,
+                file: plugin.file,
+                plugin_id: plugin.id,
+                ok: false,
+                status: 'runner_error',
+                reason: 'spawn_failed',
+                error: error.message,
+                durationMs: duration,
+                duration_ms: duration,
+            });
+        });
+        child.on('close', () => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(timer);
+            const duration = Date.now() - started;
+            if (timedOut) {
+                resolve({
+                    plugin: plugin.id,
+                    path: plugin.path,
+                    file: plugin.file,
+                    plugin_id: plugin.id,
+                    ok: false,
+                    status: 'timeout',
+                    reason: 'timeout',
+                    durationMs: duration,
+                    duration_ms: duration,
+                });
+                return;
+            }
+            const lines = stdout.split('\n').map((line) => line.trim()).filter(Boolean);
+            const rawResult = [...lines].reverse().find((line) => line.startsWith(RESULT_PREFIX));
+            let parsed = null;
+            if (rawResult) {
+                try {
+                    parsed = JSON.parse(rawResult.slice(RESULT_PREFIX.length));
+                }
+                catch {
+                    parsed = null;
+                }
+            }
+            if (parsed?.ok) {
+                resolve({
+                    plugin: plugin.id,
+                    path: plugin.path,
+                    file: plugin.file,
+                    plugin_id: plugin.id,
+                    ok: true,
+                    status: 'ok',
+                    reason: parsed.reason || 'ok',
+                    durationMs: duration,
+                    duration_ms: duration,
+                });
+                return;
+            }
+            const reason = parsed?.reason || 'plugin_error';
+            resolve({
+                plugin: plugin.id,
+                path: plugin.path,
+                file: plugin.file,
+                plugin_id: plugin.id,
+                ok: false,
+                status: reason === 'invalid_export' ? 'invalid_export' : 'error',
+                reason,
+                error: parsed?.error || stderr.trim() || undefined,
+                durationMs: duration,
+                duration_ms: duration,
+            });
+        });
+        child.stdin.write(JSON.stringify({
+            cwd: options.cwd,
+            pluginId: plugin.id,
+            pluginPath: plugin.path,
+            event,
+            sideEffectsEnabled,
+        }));
+        child.stdin.end();
+    });
+}
+export function isHookPluginFeatureEnabled(env = process.env) {
+    return isHookPluginsEnabled(env);
+}
+export async function dispatchHookEvent(event, options = {}) {
+    const cwd = options.cwd || process.cwd();
+    const env = options.env || process.env;
+    const enabled = options.enabled ?? isHookPluginsEnabled(env);
+    const summary = {
+        enabled,
+        reason: enabled ? 'ok' : 'disabled',
+        event: event.event,
+        source: event.source,
+        plugin_count: 0,
+        results: [],
+    };
+    if (!enabled) {
+        await appendHooksLog(cwd, {
+            type: 'hook_dispatch',
+            event: event.event,
+            source: event.source,
+            enabled: false,
+            reason: 'plugins_disabled',
+        });
+        return summary;
+    }
+    const plugins = await discoverHookPlugins(cwd);
+    summary.plugin_count = plugins.length;
+    const inTeamWorker = isTeamWorker(env);
+    const allowTeamSideEffects = options.allowTeamWorkerSideEffects ?? options.allowInTeamWorker ?? false;
+    const sideEffectsEnabled = options.sideEffectsEnabled ?? (!inTeamWorker || allowTeamSideEffects);
+    for (const plugin of plugins) {
+        const validation = await validateHookPluginExport(plugin.path);
+        if (!validation.valid) {
+            const invalid = {
+                plugin: plugin.id,
+                path: plugin.path,
+                file: plugin.file,
+                plugin_id: plugin.id,
+                ok: false,
+                status: 'invalid_export',
+                reason: validation.reason || 'invalid_export',
+                durationMs: 0,
+                duration_ms: 0,
+            };
+            summary.results.push(invalid);
+            await appendHooksLog(cwd, {
+                type: 'hook_plugin_dispatch',
+                event: event.event,
+                source: event.source,
+                plugin: plugin.id,
+                file: plugin.file,
+                ok: false,
+                status: invalid.status,
+                reason: invalid.reason,
+            });
+            continue;
+        }
+        const result = await runPluginRunner(plugin, event, { ...options, cwd, env }, sideEffectsEnabled);
+        summary.results.push(result);
+        await appendHooksLog(cwd, {
+            type: 'hook_plugin_dispatch',
+            event: event.event,
+            source: event.source,
+            plugin: plugin.id,
+            file: plugin.file,
+            ok: result.ok,
+            status: result.status,
+            reason: result.reason,
+            error: result.error,
+            duration_ms: result.duration_ms,
+        });
+    }
+    return summary;
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/hooks/extensibility/dispatcher.js.map

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

package/dist/hooks/extensibility/events.d.ts

@@ -0,0 +1,18 @@
+import type { HookEventEnvelope, HookEventName, HookEventSource } from './types.js';
+interface BuildHookEventOptions {
+    source?: HookEventSource;
+    timestamp?: string;
+    context?: Record<string, unknown>;
+    session_id?: string;
+    thread_id?: string;
+    turn_id?: string;
+    mode?: string;
+    confidence?: number;
+    parser_reason?: string;
+}
+export declare function isDerivedEventName(event: string): boolean;
+export declare function buildHookEvent(event: HookEventName | string, options?: BuildHookEventOptions): HookEventEnvelope;
+export declare function buildNativeHookEvent(event: HookEventName | string, context?: Record<string, unknown>, options?: Omit<BuildHookEventOptions, 'source' | 'confidence' | 'parser_reason' | 'context'>): HookEventEnvelope;
+export declare function buildDerivedHookEvent(event: HookEventName | string, context?: Record<string, unknown>, options?: Omit<BuildHookEventOptions, 'source' | 'context'>): HookEventEnvelope;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/hooks/extensibility/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/hooks/extensibility/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIpF,UAAU,qBAAqB;IAC7B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AASD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,GAAG,MAAM,EAC7B,OAAO,GAAE,qBAA0B,GAClC,iBAAiB,CAuBnB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,GAAG,MAAM,EAC7B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,YAAY,GAAG,eAAe,GAAG,SAAS,CAAM,GAC/F,iBAAiB,CAMnB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,GAAG,MAAM,EAC7B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,SAAS,CAAM,GAC9D,iBAAiB,CAMnB"}

package/dist/hooks/extensibility/events.js

@@ -0,0 +1,53 @@
+const DERIVED_EVENTS = new Set(['needs-input', 'pre-tool-use', 'post-tool-use']);
+function clampConfidence(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return undefined;
+    if (value < 0)
+        return 0;
+    if (value > 1)
+        return 1;
+    return value;
+}
+export function isDerivedEventName(event) {
+    return DERIVED_EVENTS.has(event);
+}
+export function buildHookEvent(event, options = {}) {
+    const source = options.source || (isDerivedEventName(event) ? 'derived' : 'native');
+    const confidence = clampConfidence(options.confidence);
+    const envelope = {
+        schema_version: '1',
+        event,
+        timestamp: options.timestamp || new Date().toISOString(),
+        source,
+        context: options.context && typeof options.context === 'object' ? options.context : {},
+    };
+    if (options.session_id)
+        envelope.session_id = options.session_id;
+    if (options.thread_id)
+        envelope.thread_id = options.thread_id;
+    if (options.turn_id)
+        envelope.turn_id = options.turn_id;
+    if (options.mode)
+        envelope.mode = options.mode;
+    if (source === 'derived') {
+        envelope.confidence = confidence ?? 0.5;
+        if (options.parser_reason)
+            envelope.parser_reason = options.parser_reason;
+    }
+    return envelope;
+}
+export function buildNativeHookEvent(event, context = {}, options = {}) {
+    return buildHookEvent(event, {
+        ...options,
+        source: 'native',
+        context,
+    });
+}
+export function buildDerivedHookEvent(event, context = {}, options = {}) {
+    return buildHookEvent(event, {
+        ...options,
+        source: 'derived',
+        context,
+    });
+}
+//# sourceMappingURL=events.js.map

package/dist/hooks/extensibility/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/hooks/extensibility/events.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,CAAC,aAAa,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;AAczF,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3E,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACxB,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAA6B,EAC7B,UAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACpF,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAsB;QAClC,cAAc,EAAE,GAAG;QACnB,KAAK;QACL,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACxD,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;KACvF,CAAC;IAEF,IAAI,OAAO,CAAC,UAAU;QAAE,QAAQ,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACjE,IAAI,OAAO,CAAC,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAC9D,IAAI,OAAO,CAAC,OAAO;QAAE,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACxD,IAAI,OAAO,CAAC,IAAI;QAAE,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,QAAQ,CAAC,UAAU,GAAG,UAAU,IAAI,GAAG,CAAC;QACxC,IAAI,OAAO,CAAC,aAAa;YAAE,QAAQ,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC5E,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAA6B,EAC7B,UAAmC,EAAE,EACrC,UAA8F,EAAE;IAEhG,OAAO,cAAc,CAAC,KAAK,EAAE;QAC3B,GAAG,OAAO;QACV,MAAM,EAAE,QAAQ;QAChB,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAA6B,EAC7B,UAAmC,EAAE,EACrC,UAA6D,EAAE;IAE/D,OAAO,cAAc,CAAC,KAAK,EAAE;QAC3B,GAAG,OAAO;QACV,MAAM,EAAE,SAAS;QACjB,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/hooks/extensibility/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './events.js';
+export * from './loader.js';
+export * from './dispatcher.js';
+export * from './sdk.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/extensibility/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/extensibility/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}

package/dist/hooks/extensibility/index.js

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './events.js';
+export * from './loader.js';
+export * from './dispatcher.js';
+export * from './sdk.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/extensibility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/extensibility/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}

package/dist/hooks/extensibility/loader.d.ts

@@ -0,0 +1,14 @@
+import type { HookPluginDescriptor } from './types.js';
+export declare const HOOK_PLUGIN_ENABLE_ENV = "OMX_HOOK_PLUGINS";
+export declare const HOOK_PLUGIN_TIMEOUT_ENV = "OMX_HOOK_PLUGIN_TIMEOUT_MS";
+export declare function hooksDir(cwd: string): string;
+export declare function isHookPluginsEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function resolveHookPluginTimeoutMs(env?: NodeJS.ProcessEnv, fallback?: number): number;
+export declare function ensureHooksDir(cwd: string): Promise<string>;
+export declare function validateHookPluginExport(pluginPath: string): Promise<{
+    valid: boolean;
+    reason?: string;
+}>;
+export declare function discoverHookPlugins(cwd: string): Promise<HookPluginDescriptor[]>;
+export declare function loadHookPluginDescriptors(cwd: string): Promise<HookPluginDescriptor[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/hooks/extensibility/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/hooks/extensibility/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AACzD,eAAO,MAAM,uBAAuB,+BAA+B,CAAC;AAsBpE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAGlF;AAED,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,SAAO,GACd,MAAM,CAER;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIjE;AAiBD,wBAAsB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAE/G;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA2BtF;AAED,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAY5F"}

package/dist/hooks/extensibility/loader.js

@@ -0,0 +1,102 @@
+import { existsSync } from 'fs';
+import { mkdir, readdir, stat } from 'fs/promises';
+import { basename, join } from 'path';
+import { pathToFileURL } from 'url';
+export const HOOK_PLUGIN_ENABLE_ENV = 'OMX_HOOK_PLUGINS';
+export const HOOK_PLUGIN_TIMEOUT_ENV = 'OMX_HOOK_PLUGIN_TIMEOUT_MS';
+function sanitizePluginId(fileName) {
+    const stem = basename(fileName, '.mjs');
+    const normalized = stem
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return normalized || 'plugin';
+}
+function readTimeout(raw, fallback) {
+    if (!raw)
+        return fallback;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed))
+        return fallback;
+    const rounded = Math.floor(parsed);
+    if (rounded < 100)
+        return 100;
+    if (rounded > 60_000)
+        return 60_000;
+    return rounded;
+}
+export function hooksDir(cwd) {
+    return join(cwd, '.omx', 'hooks');
+}
+export function isHookPluginsEnabled(env = process.env) {
+    const raw = `${env[HOOK_PLUGIN_ENABLE_ENV] ?? ''}`.trim().toLowerCase();
+    return raw === '1' || raw === 'true' || raw === 'yes';
+}
+export function resolveHookPluginTimeoutMs(env = process.env, fallback = 1500) {
+    return readTimeout(env[HOOK_PLUGIN_TIMEOUT_ENV], fallback);
+}
+export async function ensureHooksDir(cwd) {
+    const dir = hooksDir(cwd);
+    await mkdir(dir, { recursive: true });
+    return dir;
+}
+async function validatePluginExport(pluginPath) {
+    try {
+        const mod = await import(`${pathToFileURL(pluginPath).href}?v=${Date.now()}`);
+        if (!mod || typeof mod.onHookEvent !== 'function') {
+            return { valid: false, reason: 'missing_onHookEvent_export' };
+        }
+        return { valid: true };
+    }
+    catch (err) {
+        return {
+            valid: false,
+            reason: err instanceof Error ? err.message : 'failed_to_import_plugin',
+        };
+    }
+}
+export async function validateHookPluginExport(pluginPath) {
+    return validatePluginExport(pluginPath);
+}
+export async function discoverHookPlugins(cwd) {
+    const dir = hooksDir(cwd);
+    if (!existsSync(dir))
+        return [];
+    const names = await readdir(dir).catch(() => []);
+    const plugins = [];
+    for (const name of names) {
+        if (!name.endsWith('.mjs'))
+            continue;
+        const path = join(dir, name);
+        const st = await stat(path).catch(() => null);
+        if (!st || !st.isFile())
+            continue;
+        const id = sanitizePluginId(name);
+        plugins.push({
+            id,
+            name: id,
+            file: name,
+            path,
+            filePath: path,
+            fileName: name,
+            valid: true,
+        });
+    }
+    plugins.sort((a, b) => a.file.localeCompare(b.file));
+    return plugins;
+}
+export async function loadHookPluginDescriptors(cwd) {
+    const discovered = await discoverHookPlugins(cwd);
+    const validated = [];
+    for (const plugin of discovered) {
+        const validation = await validatePluginExport(plugin.path);
+        validated.push({
+            ...plugin,
+            valid: validation.valid,
+            reason: validation.reason,
+        });
+    }
+    return validated;
+}
+//# sourceMappingURL=loader.js.map

package/dist/hooks/extensibility/loader.js.map

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

package/dist/hooks/extensibility/logging.d.ts

@@ -0,0 +1,4 @@
+import type { HookPluginLogContext } from './types.js';
+export declare function hookLogPath(cwd: string, timestamp?: Date): string;
+export declare function appendHookPluginLog(cwd: string, entry: HookPluginLogContext): Promise<void>;
+//# sourceMappingURL=logging.d.ts.map