@codemieai/code 0.1.0 → 0.2.0

package/dist/agents/plugins/codex/codex.incremental-sync.js

@@ -0,0 +1,147 @@
+// src/agents/plugins/codex/codex.incremental-sync.ts
+/**
+ * Codex Incremental Sync Timer
+ *
+ * In-process timer that periodically re-parses the active Codex rollout file
+ * and writes per-call_id metric deltas + new conversation slices to JSONL.
+ *
+ * Why this exists: Codex 0.129.0 advertises a `hooks` feature, but on
+ * 2026-05-09 smoke tests on `codex exec` neither -c overrides
+ * (`-c 'hooks.SessionStart=[...]'`) nor a direct `[[hooks.SessionStart]]`
+ * block in `~/.codex/config.toml` fired the configured command. See
+ * docs/superpowers/plans/2026-05-09-codex-hooks-incremental-sync.md.
+ *
+ * The incremental sync timer writes per-call_id metric deltas + new
+ * conversation slices to JSONL on every tick, then uploads PENDING payloads
+ * to the CodeMie API via SessionSyncer when SSO credentials are available.
+ */
+import { realpath as fsRealpath } from 'fs/promises';
+import { CodexSessionAdapter } from './codex.session.js';
+import { logger } from '../../../utils/logger.js';
+const DEFAULT_INTERVAL_MS = 30_000;
+const STARTED_AT_GRACE_MS = 10_000;
+const activeTimers = new Map();
+const tickInFlight = new Map();
+export function startCodexIncrementalSync(options) {
+    if (process.env.CODEMIE_CODEX_SYNC_ENABLED === 'false') {
+        logger.debug('[codex-incremental-sync] Disabled by CODEMIE_CODEX_SYNC_ENABLED=false');
+        return;
+    }
+    if (activeTimers.has(options.sessionId)) {
+        logger.debug(`[codex-incremental-sync] Already running for session ${options.sessionId}`);
+        return;
+    }
+    const intervalMs = Number(process.env.CODEMIE_CODEX_SYNC_INTERVAL_MS) || DEFAULT_INTERVAL_MS;
+    const tick = async () => {
+        if (tickInFlight.get(options.sessionId))
+            return;
+        tickInFlight.set(options.sessionId, true);
+        try {
+            const adapter = new CodexSessionAdapter(options.metadata);
+            const sessions = await adapter.discoverSessions({ maxAgeDays: 1, limit: 10 });
+            if (sessions.length === 0)
+                return;
+            const cwdReal = await safeRealpath(options.cwd);
+            for (const descriptor of sessions) {
+                if (descriptor.createdAt < options.startedAt - STARTED_AT_GRACE_MS)
+                    continue;
+                let parsed;
+                try {
+                    parsed = await adapter.parseSessionFile(descriptor.filePath, options.sessionId);
+                }
+                catch (error) {
+                    logger.debug('[codex-incremental-sync] parse failed, skipping', error);
+                    continue;
+                }
+                const projectPath = parsed.metadata?.projectPath;
+                if (!projectPath)
+                    continue;
+                const projectReal = await safeRealpath(projectPath);
+                if (projectReal !== cwdReal)
+                    continue;
+                try {
+                    const result = await adapter.processSession(descriptor.filePath, options.sessionId, options.buildContext());
+                    logger.debug(`[codex-incremental-sync] tick ok session=${options.sessionId} records=${result.totalRecords}`);
+                }
+                catch (error) {
+                    logger.error('[codex-incremental-sync] processSession failed:', error);
+                }
+                if (options.ssoUrl && options.syncApiUrl) {
+                    try {
+                        const uploadContext = await buildUploadContext(options.sessionId, options.ssoUrl, options.syncApiUrl, options.cliVersion);
+                        if (uploadContext) {
+                            const { SessionSyncer } = await import('../../../providers/plugins/sso/session/SessionSyncer.js');
+                            const syncer = new SessionSyncer();
+                            const syncResult = await syncer.sync(options.sessionId, uploadContext);
+                            logger.debug(`[codex-incremental-sync] upload ${syncResult.success ? 'ok' : 'partial'}: ${syncResult.message}`);
+                        }
+                    }
+                    catch (error) {
+                        logger.error('[codex-incremental-sync] upload failed:', error);
+                    }
+                }
+                return; // Only the most recent matching rollout per tick.
+            }
+        }
+        catch (error) {
+            logger.error('[codex-incremental-sync] tick failed:', error);
+        }
+        finally {
+            tickInFlight.set(options.sessionId, false);
+        }
+    };
+    const timer = setInterval(() => {
+        void tick();
+    }, intervalMs);
+    // Don't pin the Node event loop alive solely on this timer; if the parent
+    // process is otherwise idle we want it to exit cleanly when Codex finishes.
+    if (typeof timer.unref === 'function') {
+        timer.unref();
+    }
+    activeTimers.set(options.sessionId, timer);
+    logger.debug(`[codex-incremental-sync] Started (session=${options.sessionId}, intervalMs=${intervalMs})`);
+}
+export function stopCodexIncrementalSync(sessionId) {
+    const timer = activeTimers.get(sessionId);
+    if (!timer)
+        return;
+    clearInterval(timer);
+    activeTimers.delete(sessionId);
+    tickInFlight.delete(sessionId);
+    logger.debug(`[codex-incremental-sync] Stopped (session=${sessionId})`);
+}
+async function buildUploadContext(sessionId, ssoUrl, syncApiUrl, version = '0.0.0') {
+    try {
+        const { CodeMieSSO } = await import('../../../providers/plugins/sso/sso.auth.js');
+        const sso = new CodeMieSSO();
+        const credentials = await sso.getStoredCredentials(ssoUrl);
+        if (!credentials?.cookies) {
+            logger.debug('[codex-incremental-sync] No SSO credentials available, skipping upload');
+            return null;
+        }
+        const cookies = Object.entries(credentials.cookies)
+            .map(([k, v]) => `${k}=${v}`)
+            .join('; ');
+        return {
+            apiBaseUrl: syncApiUrl,
+            cookies,
+            clientType: 'codemie-codex',
+            version,
+            dryRun: false,
+            sessionId,
+        };
+    }
+    catch (error) {
+        logger.debug('[codex-incremental-sync] Failed to build upload context:', error);
+        return null;
+    }
+}
+async function safeRealpath(p) {
+    try {
+        return await fsRealpath(p);
+    }
+    catch {
+        return p;
+    }
+}
+//# sourceMappingURL=codex.incremental-sync.js.map

package/dist/agents/plugins/codex/codex.incremental-sync.js.map

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

package/dist/agents/plugins/codex/codex.paths.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Codex path utilities.
+ *
+ * Codex stores rollout files at:
+ *   ${CODEX_HOME:-~/.codex}/sessions/YYYY/MM/DD/rollout-{ISO8601}-{uuid}.jsonl
+ *
+ * Codex does not use XDG conventions by default, but it supports CODEX_HOME
+ * for isolating local state.
+ *
+ * References:
+ * - https://developers.openai.com/codex/config-advanced
+ */
+/**
+ * Returns the Codex home directory.
+ */
+export declare function getCodexHomePath(): string;
+/**
+ * Returns the Codex sessions base directory.
+ * Returns null if the directory does not exist (Codex not run yet).
+ */
+export declare function getCodexSessionsPath(): string | null;
+/**
+ * Returns the day-specific session directory for a given date:
+ *   ${CODEX_HOME:-~/.codex}/sessions/YYYY/MM/DD
+ *
+ * Note: This directory may not exist yet.
+ */
+export declare function getCodexSessionDayPath(date: Date): string;
+//# sourceMappingURL=codex.paths.d.ts.map

package/dist/agents/plugins/codex/codex.paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.paths.d.ts","sourceRoot":"","sources":["../../../../src/agents/plugins/codex/codex.paths.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAMH;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAGpD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKzD"}

package/dist/agents/plugins/codex/codex.paths.js

@@ -0,0 +1,43 @@
+// src/agents/plugins/codex/codex.paths.ts
+/**
+ * Codex path utilities.
+ *
+ * Codex stores rollout files at:
+ *   ${CODEX_HOME:-~/.codex}/sessions/YYYY/MM/DD/rollout-{ISO8601}-{uuid}.jsonl
+ *
+ * Codex does not use XDG conventions by default, but it supports CODEX_HOME
+ * for isolating local state.
+ *
+ * References:
+ * - https://developers.openai.com/codex/config-advanced
+ */
+import { homedir } from 'os';
+import { join } from 'path';
+import { existsSync } from 'fs';
+/**
+ * Returns the Codex home directory.
+ */
+export function getCodexHomePath() {
+    return process.env.CODEX_HOME || join(homedir(), '.codex');
+}
+/**
+ * Returns the Codex sessions base directory.
+ * Returns null if the directory does not exist (Codex not run yet).
+ */
+export function getCodexSessionsPath() {
+    const sessionsPath = join(getCodexHomePath(), 'sessions');
+    return existsSync(sessionsPath) ? sessionsPath : null;
+}
+/**
+ * Returns the day-specific session directory for a given date:
+ *   ${CODEX_HOME:-~/.codex}/sessions/YYYY/MM/DD
+ *
+ * Note: This directory may not exist yet.
+ */
+export function getCodexSessionDayPath(date) {
+    const year = date.getFullYear().toString();
+    const month = (date.getMonth() + 1).toString().padStart(2, '0');
+    const day = date.getDate().toString().padStart(2, '0');
+    return join(getCodexHomePath(), 'sessions', year, month, day);
+}
+//# sourceMappingURL=codex.paths.js.map

package/dist/agents/plugins/codex/codex.paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.paths.js","sourceRoot":"","sources":["../../../../src/agents/plugins/codex/codex.paths.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,EAAE,UAAU,CAAC,CAAC;IAC1D,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAU;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAChE,CAAC"}

package/dist/agents/plugins/codex/codex.plugin.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Codex Agent Plugin
+ *
+ * Registers OpenAI Codex CLI (@openai/codex) as a selectable agent in CodeMie.
+ *
+ * Config injection strategy:
+ * - CODEMIE_BASE_URL  → OPENAI_BASE_URL  (env var, picked up natively by Codex)
+ * - CODEMIE_API_KEY   → OPENAI_API_KEY + CODEMIE_API_KEY (env vars via transformEnvVars)
+ * - Model injected via: --model <model>
+ * - Provider: model_providers.codemie with env_key=CODEMIE_API_KEY (bypasses ~/.codex/auth.json)
+ *   auth.json has highest priority for the default openai provider; a custom provider with
+ *   env_key pointing to CODEMIE_API_KEY bypasses it since auth.json only covers openai.
+ *
+ * Session lifecycle (CLI-level via processEvent):
+ * 1. onSessionStart  → processEvent(SessionStart) — creates session record + sends start metrics
+ *                    → startCodexIncrementalSync — kicks off the in-process timer
+ * 2. enrichArgs      → transform --task, inject --model + model_providers.codemie + tuning flags
+ * 3. [Codex runs]
+ * 4. onSessionEnd    → stopCodexIncrementalSync → process rollout → processEvent(SessionEnd)
+ *
+ * Why no Codex hooks?
+ * Codex 0.129.0 advertises a `hooks` feature (stable per `codex features list`),
+ * but smoke tests on 2026-05-09 showed that neither -c overrides
+ * (`-c 'hooks.SessionStart=[...]'`) nor a direct `[[hooks.SessionStart]]` block
+ * in `~/.codex/config.toml` fired the configured command in `codex exec`.
+ * See docs/superpowers/plans/2026-05-09-codex-hooks-incremental-sync.md
+ * and https://github.com/openai/codex/issues/17532.
+ *
+ * Until the actual hook delivery mechanism is documented (likely tied to the
+ * `~/.codex/plugins/<name>/.codex-plugin/plugin.json` plugin manifest format),
+ * we run an in-process timer (codex.incremental-sync.ts) inside `codemie-cli`
+ * to keep `_metrics.jsonl` and `_conversation.jsonl` warm. The SSO proxy timer
+ * (sso.session-sync.plugin.ts) handles the API push as usual.
+ *
+ * References:
+ * - OpenAI Codex CLI: https://github.com/openai/codex
+ * - Configuration: https://github.com/openai/codex/blob/main/codex-rs/docs/configuration.md
+ * - Advanced config: https://developers.openai.com/codex/config-advanced
+ * - CLI Reference: https://github.com/openai/codex/blob/main/codex-rs/docs/cli-reference.md
+ * - Hooks (deferred): https://developers.openai.com/codex/hooks
+ */
+import type { AgentMetadata } from '../../core/types.js';
+import { BaseAgentAdapter } from '../../core/BaseAgentAdapter.js';
+import type { SessionAdapter } from '../../core/session/BaseSessionAdapter.js';
+import type { BaseExtensionInstaller } from '../../core/extension/BaseExtensionInstaller.js';
+export declare const CodexPluginMetadata: AgentMetadata;
+/**
+ * Codex agent plugin
+ *
+ * Phase 1: Core plugin with CLI wrapping and session tracking.
+ * Phase 2: Rollout file analytics — discovery, parsing, MetricDelta writing.
+ */
+export declare class CodexPlugin extends BaseAgentAdapter {
+    private readonly sessionAdapter;
+    constructor();
+    /**
+     * Check whether the `codex` binary is available on PATH.
+     * Respects CODEMIE_CODEX_BIN environment variable override.
+     */
+    isInstalled(): Promise<boolean>;
+    /**
+     * Get Codex version (override from BaseAgentAdapter).
+     * Codex versions can be emitted as plain semver or with a command prefix,
+     * for example: '0.129.0', 'codex 0.129.0', or 'codex-cli 0.129.0'.
+     * Base compatibility checks require just the semantic version.
+     *
+     * @returns Version string or null if not installed
+     */
+    getVersion(): Promise<string | null>;
+    protected setupProxy(env: NodeJS.ProcessEnv): Promise<void>;
+    /**
+     * Return session adapter for rollout analytics.
+     */
+    getSessionAdapter(): SessionAdapter;
+    /**
+     * No extension installer — Codex is installed directly via npm.
+     */
+    getExtensionInstaller(): BaseExtensionInstaller | undefined;
+}
+//# sourceMappingURL=codex.plugin.d.ts.map

package/dist/agents/plugins/codex/codex.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.plugin.d.ts","sourceRoot":"","sources":["../../../../src/agents/plugins/codex/codex.plugin.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE/E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AAyD7F,eAAO,MAAM,mBAAmB,EAAE,aA4SjC,CAAC;AA6BF;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,gBAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;;IAOhD;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;cAejB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB1E;;OAEG;IACH,iBAAiB,IAAI,cAAc;IAInC;;OAEG;IACH,qBAAqB,IAAI,sBAAsB,GAAG,SAAS;CAG5D"}