instar 0.28.113 → 0.28.115

package/dist/providers/adapters/openai-codex/index.js

@@ -0,0 +1,135 @@
+/**
+ * openai-codex adapter — entry point.
+ *
+ * First non-Anthropic adapter. Mirrors the anthropic-headless adapter
+ * shape but uses Codex CLI's surface (`codex exec`, JSONL events, app-
+ * server, `.codex/`, `~/.codex/`). Per the deep-dive, 35 of 36 universal
+ * primitives map cleanly; the asymmetric ones (PreCompactHook,
+ * SubagentLifecycleHooks, PublicUsageApi, NativeIdleBound) are NOT
+ * declared in capabilities.ts so the registry honestly reports them as
+ * unavailable on this adapter. StructuredApprovalEvents IS declared
+ * because the Codex app-server emits structured approval requests.
+ *
+ * Usage:
+ *
+ *   import { createOpenAiCodexAdapter } from
+ *     './providers/adapters/openai-codex/index.js';
+ *   import { registry } from './providers/registry.js';
+ *
+ *   await registry.register(createOpenAiCodexAdapter({ ... }));
+ */
+import { UnsupportedCapabilityError, AuthError } from '../../errors.js';
+import { openAiCodexCapabilities } from './capabilities.js';
+import { OPENAI_CODEX_ID } from './errors.js';
+import { configFromEnv } from './config.js';
+import { checkAndWarn as rule1CheckAndWarn, resolveEnforcementMode as rule1ResolveMode } from './credentials.js';
+import { createOneShotCompletion } from './transport/oneShotCompletion.js';
+import { createStructuredOneShot } from './transport/structuredOneShot.js';
+import { createAgenticSessionHeadless } from './transport/agenticSessionHeadless.js';
+import { createToolAccess } from './capability/toolAccess.js';
+import { createToolAllowlist } from './capability/toolAllowlist.js';
+import { createFileSystemAccess } from './capability/fileSystemAccess.js';
+import { createPathAllowlist } from './capability/pathAllowlist.js';
+import { createBashExecution } from './capability/bashExecution.js';
+import { createWebAccess } from './capability/webAccess.js';
+import { createLiveOutputStream } from './observability/liveOutputStream.js';
+import { createConversationLogReader } from './observability/conversationLogReader.js';
+import { createConversationLogTailer } from './observability/conversationLogTailer.js';
+import { createHookEventReceiver } from './observability/hookEventReceiver.js';
+import { createSubagentLifecycleObserver } from './observability/subagentLifecycleObserver.js';
+import { createSessionId } from './observability/sessionId.js';
+import { createUsageMeterProvider } from './observability/usageMeterProvider.js';
+import { createProcessLifecycle } from './observability/processLifecycle.js';
+import { createInteractivePromptObserver } from './observability/interactivePromptObserver.js';
+import { createInputInjection } from './control/inputInjection.js';
+import { createHardKill } from './control/hardKill.js';
+import { createInterrupt } from './control/interrupt.js';
+import { createStopGateInterceptor } from './control/stopGateInterceptor.js';
+import { createTimeoutBound } from './control/timeoutBound.js';
+import { createIdleBound } from './control/idleBound.js';
+import { createAuthCredentialInjection } from './control/authCredentialInjection.js';
+import { createCredentialStorageProvider } from './control/credentialStorageProvider.js';
+import { createContextScopeControl } from './control/contextScopeControl.js';
+import { createCompactionLifecycle } from './control/compactionLifecycle.js';
+import { createProviderScaffolder } from './integration/providerScaffolder.js';
+import { createMcpToolRegistry } from './integration/mcpToolRegistry.js';
+import { createSessionResumeIndex } from './integration/sessionResumeIndex.js';
+import { createConversationLogProviderImpl } from './integration/conversationLogProvider.js';
+import { CapabilityFlag as Cap } from '../../capabilities.js';
+/**
+ * Create the openai-codex adapter with the given config (or environment
+ * defaults if omitted).
+ */
+export function createOpenAiCodexAdapter(partialConfig = {}) {
+    const config = {
+        ...configFromEnv(),
+        ...partialConfig,
+    };
+    // Spec 12 Rule 1 enforcement at adapter init. Phase A default is
+    // 'warn' — surfaces the violation but does not refuse. 'hard' mode
+    // (set INSTAR_RULE1_ENFORCE=hard) throws AuthError to block routing.
+    // 'disabled' mode (INSTAR_DISABLE_RULE1_OPENAI=1) suppresses entirely
+    // and sunsets on RULE1_KILLSWITCH_SUNSET_DATE.
+    const rule1Result = rule1CheckAndWarn({
+        stateDir: partialConfig.defaultWorkingDirectory
+            ? `${partialConfig.defaultWorkingDirectory}/.instar`
+            : undefined,
+    });
+    const rule1Mode = rule1ResolveMode();
+    if (!rule1Result.ok && rule1Mode === 'hard') {
+        // Phase B (opt-in for v1.0.0; default in v1.1) — hard refuse.
+        throw new AuthError(`[codex.rule1] Adapter refused: ${rule1Result.code} (${rule1Result.detail ?? 'no detail'}). Set INSTAR_RULE1_ENFORCE=warn to downgrade to warning-only (Phase A behavior), or fix the underlying credential.`, OPENAI_CODEX_ID);
+    }
+    const impls = new Map();
+    // Transport
+    impls.set(Cap.OneShotCompletion, createOneShotCompletion(config));
+    impls.set(Cap.StructuredOneShot, createStructuredOneShot(config));
+    impls.set(Cap.AgenticSessionHeadless, createAgenticSessionHeadless(config));
+    // Capability
+    impls.set(Cap.ToolAccess, createToolAccess());
+    impls.set(Cap.ToolAllowlist, createToolAllowlist());
+    impls.set(Cap.FileSystemAccess, createFileSystemAccess());
+    impls.set(Cap.PathAllowlist, createPathAllowlist());
+    impls.set(Cap.BashExecution, createBashExecution());
+    impls.set(Cap.WebAccess, createWebAccess());
+    // Observability
+    impls.set(Cap.LiveOutputStream, createLiveOutputStream(config));
+    impls.set(Cap.ConversationLogReader, createConversationLogReader(config));
+    impls.set(Cap.ConversationLogTailer, createConversationLogTailer(config));
+    impls.set(Cap.HookEventReceiver, createHookEventReceiver());
+    impls.set(Cap.SubagentLifecycleObserver, createSubagentLifecycleObserver());
+    impls.set(Cap.SessionId, createSessionId());
+    impls.set(Cap.UsageMeterProvider, createUsageMeterProvider());
+    impls.set(Cap.ProcessLifecycle, createProcessLifecycle(config));
+    impls.set(Cap.InteractivePromptObserver, createInteractivePromptObserver(config));
+    // Control
+    impls.set(Cap.InputInjection, createInputInjection(config));
+    impls.set(Cap.HardKill, createHardKill(config));
+    impls.set(Cap.Interrupt, createInterrupt(config));
+    impls.set(Cap.StopGateInterceptor, createStopGateInterceptor());
+    impls.set(Cap.TimeoutBound, createTimeoutBound());
+    impls.set(Cap.IdleBound, createIdleBound());
+    impls.set(Cap.AuthCredentialInjection, createAuthCredentialInjection());
+    impls.set(Cap.CredentialStorageProvider, createCredentialStorageProvider());
+    impls.set(Cap.ContextScopeControl, createContextScopeControl());
+    impls.set(Cap.CompactionLifecycle, createCompactionLifecycle());
+    // Integration
+    impls.set(Cap.ProviderScaffolder, createProviderScaffolder());
+    impls.set(Cap.McpToolRegistry, createMcpToolRegistry());
+    impls.set(Cap.SessionResumeIndex, createSessionResumeIndex(config));
+    impls.set(Cap.ConversationLogProvider, createConversationLogProviderImpl(config));
+    return {
+        id: OPENAI_CODEX_ID,
+        capabilities: openAiCodexCapabilities,
+        primitive(capability) {
+            const impl = impls.get(capability);
+            if (impl === undefined) {
+                throw new UnsupportedCapabilityError(capability, OPENAI_CODEX_ID);
+            }
+            return impl;
+        },
+    };
+}
+export { configFromEnv } from './config.js';
+export { OPENAI_CODEX_ID } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/adapters/openai-codex/index.js.map

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

package/dist/providers/adapters/openai-codex/integration/conversationLogProvider.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ConversationLogProvider — composite read-then-tail for openai-codex.
+ *
+ * Reads the existing rollout and then continues tailing it for new
+ * entries. Adapter handles the seamless handoff (no events dropped or
+ * duplicated at the boundary).
+ */
+import type { ConversationLogProvider } from '../../../primitives/integration/conversationLogProvider.js';
+import type { OpenAiCodexConfig } from '../config.js';
+export declare function createConversationLogProviderImpl(config: OpenAiCodexConfig): ConversationLogProvider;
+//# sourceMappingURL=conversationLogProvider.d.ts.map

package/dist/providers/adapters/openai-codex/integration/conversationLogProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogProvider.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/integration/conversationLogProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,4DAA4D,CAAC;AAKpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAkCtD,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,iBAAiB,GAAG,uBAAuB,CAEpG"}

package/dist/providers/adapters/openai-codex/integration/conversationLogProvider.js

@@ -0,0 +1,48 @@
+/**
+ * ConversationLogProvider — composite read-then-tail for openai-codex.
+ *
+ * Reads the existing rollout and then continues tailing it for new
+ * entries. Adapter handles the seamless handoff (no events dropped or
+ * duplicated at the boundary).
+ */
+import { CapabilityFlag } from '../../../capabilities.js';
+import { createConversationLogReader } from '../observability/conversationLogReader.js';
+import { createConversationLogTailer } from '../observability/conversationLogTailer.js';
+class OpenAiCodexConversationLogProvider {
+    config;
+    capability = CapabilityFlag.ConversationLogProvider;
+    constructor(config) {
+        this.config = config;
+    }
+    readAndTail(session, options) {
+        const reader = createConversationLogReader(this.config);
+        const tailer = createConversationLogTailer(this.config);
+        return {
+            async *[Symbol.asyncIterator]() {
+                const existing = await reader.read(session, {
+                    types: options?.types,
+                    since: options?.since,
+                    signal: options?.signal,
+                });
+                let lastTimestamp = options?.since ?? '';
+                for (const ev of existing) {
+                    yield ev;
+                    if (ev.timestamp > lastTimestamp)
+                        lastTimestamp = ev.timestamp;
+                }
+                for await (const ev of tailer.tail(session, {
+                    types: options?.types,
+                    signal: options?.signal,
+                })) {
+                    if (ev.timestamp <= lastTimestamp)
+                        continue;
+                    yield ev;
+                }
+            },
+        };
+    }
+}
+export function createConversationLogProviderImpl(config) {
+    return new OpenAiCodexConversationLogProvider(config);
+}
+//# sourceMappingURL=conversationLogProvider.js.map

package/dist/providers/adapters/openai-codex/integration/conversationLogProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationLogProvider.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/integration/conversationLogProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAGxF,MAAM,kCAAkC;IAGT;IAFpB,UAAU,GAAG,cAAc,CAAC,uBAAuB,CAAC;IAE7D,YAA6B,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAE1D,WAAW,CAAC,OAAsB,EAAE,OAAwC;QAC1E,MAAM,MAAM,GAAG,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,OAAO;YACL,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;gBAC3B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;oBAC1C,KAAK,EAAE,OAAO,EAAE,KAAK;oBACrB,KAAK,EAAE,OAAO,EAAE,KAAK;oBACrB,MAAM,EAAE,OAAO,EAAE,MAAM;iBACxB,CAAC,CAAC;gBACH,IAAI,aAAa,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;gBACzC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;oBAC1B,MAAM,EAAE,CAAC;oBACT,IAAI,EAAE,CAAC,SAAS,GAAG,aAAa;wBAAE,aAAa,GAAG,EAAE,CAAC,SAAS,CAAC;gBACjE,CAAC;gBACD,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;oBAC1C,KAAK,EAAE,OAAO,EAAE,KAAK;oBACrB,MAAM,EAAE,OAAO,EAAE,MAAM;iBACxB,CAAC,EAAE,CAAC;oBACH,IAAI,EAAE,CAAC,SAAS,IAAI,aAAa;wBAAE,SAAS;oBAC5C,MAAM,EAAE,CAAC;gBACX,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,iCAAiC,CAAC,MAAyB;IACzE,OAAO,IAAI,kCAAkC,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC"}

package/dist/providers/adapters/openai-codex/integration/mcpToolRegistry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * McpToolRegistry implementation for openai-codex.
+ *
+ * Codex stores MCP server definitions in `~/.codex/config.toml` under
+ * `[mcp_servers.<id>]` tables (or the project-scope `.codex/config.toml`).
+ * Identity match (command path or URL) is part of the allowlist key, not
+ * just name — required for security.
+ *
+ * Phase 4 baseline: simple TOML read/write of `[mcp_servers.*]` tables.
+ * This adapter doesn't pull in a TOML parser dependency; it serializes
+ * by hand for the limited shapes we need. A richer TOML round-trip can
+ * land in Phase 5 when the application layer actually consumes this.
+ */
+import type { McpToolRegistry } from '../../../primitives/integration/mcpToolRegistry.js';
+export declare function createMcpToolRegistry(): McpToolRegistry;
+//# sourceMappingURL=mcpToolRegistry.d.ts.map

package/dist/providers/adapters/openai-codex/integration/mcpToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/integration/mcpToolRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,oDAAoD,CAAC;AAsG5D,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/providers/adapters/openai-codex/integration/mcpToolRegistry.js

@@ -0,0 +1,116 @@
+/**
+ * McpToolRegistry implementation for openai-codex.
+ *
+ * Codex stores MCP server definitions in `~/.codex/config.toml` under
+ * `[mcp_servers.<id>]` tables (or the project-scope `.codex/config.toml`).
+ * Identity match (command path or URL) is part of the allowlist key, not
+ * just name — required for security.
+ *
+ * Phase 4 baseline: simple TOML read/write of `[mcp_servers.*]` tables.
+ * This adapter doesn't pull in a TOML parser dependency; it serializes
+ * by hand for the limited shapes we need. A richer TOML round-trip can
+ * land in Phase 5 when the application layer actually consumes this.
+ */
+import { promises as fs } from 'node:fs';
+import { homedir } from 'node:os';
+import path from 'node:path';
+import { CapabilityFlag } from '../../../capabilities.js';
+function configPath(scope, projectRoot) {
+    if (scope === 'project' && projectRoot) {
+        return path.join(projectRoot, '.codex', 'config.toml');
+    }
+    return path.join(process.env['CODEX_HOME'] || path.join(homedir(), '.codex'), 'config.toml');
+}
+function tomlEscape(s) {
+    return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+function specToToml(spec) {
+    const lines = [`[mcp_servers."${tomlEscape(spec.name)}"]`];
+    if (spec.kind === 'stdio') {
+        lines.push(`kind = "stdio"`);
+        lines.push(`command = "${tomlEscape(spec.command)}"`);
+        if (spec.args && spec.args.length) {
+            lines.push(`args = [${spec.args.map((a) => `"${tomlEscape(a)}"`).join(', ')}]`);
+        }
+        if (spec.env) {
+            lines.push(`[mcp_servers."${tomlEscape(spec.name)}".env]`);
+            for (const [k, v] of Object.entries(spec.env)) {
+                lines.push(`${k} = "${tomlEscape(v)}"`);
+            }
+        }
+    }
+    else {
+        lines.push(`kind = "http"`);
+        lines.push(`url = "${tomlEscape(spec.url)}"`);
+        if (spec.headers) {
+            lines.push(`[mcp_servers."${tomlEscape(spec.name)}".headers]`);
+            for (const [k, v] of Object.entries(spec.headers)) {
+                lines.push(`${k} = "${tomlEscape(v)}"`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+async function readExistingConfig(filePath) {
+    try {
+        return await fs.readFile(filePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+function removeMcpServerSection(content, name) {
+    const headerRe = new RegExp(`\\[mcp_servers\\."${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}"(\\.[^\\]]+)?\\][\\s\\S]*?(?=\\n\\[|$)`, 'g');
+    return content.replace(headerRe, '').replace(/\n{3,}/g, '\n\n');
+}
+class OpenAiCodexMcpToolRegistry {
+    capability = CapabilityFlag.McpToolRegistry;
+    async register(spec, options) {
+        const file = configPath(options?.scope);
+        await fs.mkdir(path.dirname(file), { recursive: true });
+        const existing = await readExistingConfig(file);
+        const cleaned = removeMcpServerSection(existing, spec.name);
+        const next = `${cleaned.trimEnd()}\n\n${specToToml(spec)}\n`;
+        await fs.writeFile(file, next, 'utf-8');
+    }
+    async unregister(name, options) {
+        const file = configPath(options?.scope);
+        const existing = await readExistingConfig(file);
+        if (!existing)
+            return;
+        await fs.writeFile(file, removeMcpServerSection(existing, name), 'utf-8');
+    }
+    async list(_options) {
+        const file = configPath('user');
+        const existing = await readExistingConfig(file);
+        if (!existing)
+            return [];
+        const out = [];
+        const re = /\[mcp_servers\."([^"]+)"\]\s*\n([\s\S]*?)(?=\n\[|$)/g;
+        let m;
+        while ((m = re.exec(existing)) !== null) {
+            const name = m[1] ?? '';
+            const body = m[2] ?? '';
+            const kindMatch = body.match(/kind\s*=\s*"(stdio|http)"/);
+            if (!kindMatch)
+                continue;
+            if (kindMatch[1] === 'stdio') {
+                const commandMatch = body.match(/command\s*=\s*"([^"]*)"/);
+                out.push({ kind: 'stdio', name, command: commandMatch?.[1] ?? '' });
+            }
+            else {
+                const urlMatch = body.match(/url\s*=\s*"([^"]*)"/);
+                out.push({ kind: 'http', name, url: urlMatch?.[1] ?? '' });
+            }
+        }
+        return out;
+    }
+    async isRegistered(name, options) {
+        const all = await this.list(options);
+        return all.some((s) => s.name === name);
+    }
+}
+export function createMcpToolRegistry() {
+    return new OpenAiCodexMcpToolRegistry();
+}
+//# sourceMappingURL=mcpToolRegistry.js.map

package/dist/providers/adapters/openai-codex/integration/mcpToolRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolRegistry.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/integration/mcpToolRegistry.ts"],"names":[],"mappings":"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"}

package/dist/providers/adapters/openai-codex/integration/providerScaffolder.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ProviderScaffolder implementation for openai-codex.
+ *
+ * Installs Codex-flavor scaffolding under a project root.
+ *
+ * Two distinct on-disk locations are involved:
+ *
+ *   1. `.agent/openai/` — Instar's standardized per-provider config bucket.
+ *      Holds AGENTS.md (instruction file), config.toml (per-project codex
+ *      overrides), and hooks.json (hook script registrations).
+ *
+ *   2. `.agents/skills/` — Codex 0.130's documented project-scope skill
+ *      discovery path. Each skill is a directory at
+ *      `.agents/skills/<name>/` with:
+ *        - SKILL.md (required) — frontmatter (name, description) + body
+ *        - agents/openai.yaml (recommended) — UI-facing metadata
+ *          (display_name, short_description), per Codex's documented format.
+ *
+ * The two paths intentionally differ: `.agent/openai/` is the Instar
+ * provider-config convention; `.agents/skills/` is the Codex-defined project
+ * skill discovery path that Codex itself walks. Co-locating skills under
+ * `.agent/openai/` (the prior layout) silently fails — Codex does not look
+ * there.
+ *
+ * Idempotent. Re-installing leaves existing files untouched unless
+ * `options.force` is set.
+ */
+import type { ProviderScaffolder } from '../../../primitives/integration/providerScaffolder.js';
+export declare function createProviderScaffolder(): ProviderScaffolder;
+//# sourceMappingURL=providerScaffolder.d.ts.map

package/dist/providers/adapters/openai-codex/integration/providerScaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerScaffolder.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/integration/providerScaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,KAAK,EACV,kBAAkB,EAKnB,MAAM,uDAAuD,CAAC;AAoK/D,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}

package/dist/providers/adapters/openai-codex/integration/providerScaffolder.js

@@ -0,0 +1,182 @@
+/**
+ * ProviderScaffolder implementation for openai-codex.
+ *
+ * Installs Codex-flavor scaffolding under a project root.
+ *
+ * Two distinct on-disk locations are involved:
+ *
+ *   1. `.agent/openai/` — Instar's standardized per-provider config bucket.
+ *      Holds AGENTS.md (instruction file), config.toml (per-project codex
+ *      overrides), and hooks.json (hook script registrations).
+ *
+ *   2. `.agents/skills/` — Codex 0.130's documented project-scope skill
+ *      discovery path. Each skill is a directory at
+ *      `.agents/skills/<name>/` with:
+ *        - SKILL.md (required) — frontmatter (name, description) + body
+ *        - agents/openai.yaml (recommended) — UI-facing metadata
+ *          (display_name, short_description), per Codex's documented format.
+ *
+ * The two paths intentionally differ: `.agent/openai/` is the Instar
+ * provider-config convention; `.agents/skills/` is the Codex-defined project
+ * skill discovery path that Codex itself walks. Co-locating skills under
+ * `.agent/openai/` (the prior layout) silently fails — Codex does not look
+ * there.
+ *
+ * Idempotent. Re-installing leaves existing files untouched unless
+ * `options.force` is set.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { CapabilityFlag } from '../../../capabilities.js';
+const PROVIDER_DIR = '.agent/openai';
+const SKILLS_DIR = '.agents/skills';
+const REQUIRED_FILES = ['AGENTS.md', 'config.toml', 'hooks.json'];
+function parseSkillFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return {};
+    const block = match[1];
+    const result = {};
+    for (const line of block.split('\n')) {
+        // Accept top-level keys (e.g. `name:`) and one-level-indented keys
+        // (e.g. `  short-description:` under a `metadata:` parent). The canonical
+        // skill format nests `short-description` under `metadata:`.
+        const m = line.match(/^\s*([a-zA-Z][\w-]*):\s*(.*)$/);
+        if (!m)
+            continue;
+        const [, key, rawValue] = m;
+        if (!rawValue)
+            continue;
+        const value = rawValue.replace(/^['"]|['"]$/g, '').trim();
+        if (key === 'name' && !result.name)
+            result.name = value;
+        else if (key === 'description' && !result.description)
+            result.description = value;
+        else if (key === 'short-description' || key === 'short_description') {
+            result.shortDescription = value;
+        }
+    }
+    return result;
+}
+function yamlEscape(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+function deriveDisplayName(name) {
+    return name
+        .split(/[-_]/)
+        .filter(Boolean)
+        .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
+        .join(' ');
+}
+function truncateForShortDescription(text) {
+    const oneLine = text.replace(/\s+/g, ' ').trim();
+    if (oneLine.length <= 64)
+        return oneLine;
+    return oneLine.slice(0, 61).trimEnd() + '...';
+}
+function buildOpenAiYaml(asset) {
+    const fm = parseSkillFrontmatter(asset.content);
+    const displayName = deriveDisplayName(fm.name ?? asset.name);
+    const shortDescription = truncateForShortDescription(fm.shortDescription ?? fm.description ?? `${displayName} skill`);
+    return [
+        'interface:',
+        `  display_name: "${yamlEscape(displayName)}"`,
+        `  short_description: "${yamlEscape(shortDescription)}"`,
+        '',
+    ].join('\n');
+}
+class OpenAiCodexProviderScaffolder {
+    capability = CapabilityFlag.ProviderScaffolder;
+    async install(projectRoot, options) {
+        const created = [];
+        const updated = [];
+        const unchanged = [];
+        const baseDir = path.join(projectRoot, PROVIDER_DIR);
+        await fs.mkdir(baseDir, { recursive: true });
+        const defaults = {
+            'AGENTS.md': '# Agent instructions\n\nThis file is loaded by Codex at session start.\n',
+            'config.toml': '# Codex per-project overrides — generated by Instar scaffolder.\n',
+            'hooks.json': '{ "hooks": [] }\n',
+        };
+        for (const name of REQUIRED_FILES) {
+            const dest = path.join(baseDir, name);
+            const content = defaults[name];
+            if (!content)
+                continue;
+            let exists = false;
+            try {
+                await fs.access(dest);
+                exists = true;
+            }
+            catch {
+                /* not present */
+            }
+            if (!exists) {
+                await fs.writeFile(dest, content, 'utf-8');
+                created.push(dest);
+            }
+            else if (options?.force) {
+                await fs.writeFile(dest, content, 'utf-8');
+                updated.push(dest);
+            }
+            else {
+                unchanged.push(dest);
+            }
+        }
+        if (options?.bundledAssets) {
+            const skillsDir = path.join(projectRoot, SKILLS_DIR);
+            let skillsDirCreated = false;
+            for (const asset of options.bundledAssets) {
+                if (asset.kind === 'skill') {
+                    if (!skillsDirCreated) {
+                        await fs.mkdir(skillsDir, { recursive: true });
+                        skillsDirCreated = true;
+                    }
+                    const skillDir = path.join(skillsDir, asset.name);
+                    await fs.mkdir(skillDir, { recursive: true });
+                    const skillMd = path.join(skillDir, 'SKILL.md');
+                    await fs.writeFile(skillMd, asset.content, 'utf-8');
+                    created.push(skillMd);
+                    const metaDir = path.join(skillDir, 'agents');
+                    await fs.mkdir(metaDir, { recursive: true });
+                    const yamlPath = path.join(metaDir, 'openai.yaml');
+                    await fs.writeFile(yamlPath, buildOpenAiYaml(asset), 'utf-8');
+                    created.push(yamlPath);
+                }
+                else if (asset.kind === 'instruction-file') {
+                    const dest = path.join(baseDir, asset.name);
+                    await fs.writeFile(dest, asset.content, 'utf-8');
+                    (options.force ? updated : created).push(dest);
+                }
+            }
+        }
+        return { created, updated, unchanged };
+    }
+    async verify(projectRoot, _options) {
+        const baseDir = path.join(projectRoot, PROVIDER_DIR);
+        const missing = [];
+        for (const name of REQUIRED_FILES) {
+            const dest = path.join(baseDir, name);
+            try {
+                await fs.access(dest);
+            }
+            catch {
+                missing.push(dest);
+            }
+        }
+        return {
+            intact: missing.length === 0,
+            missing,
+            modified: [],
+            extraneous: [],
+        };
+    }
+    async uninstall(projectRoot, _options) {
+        await fs.rm(path.join(projectRoot, PROVIDER_DIR), { recursive: true, force: true });
+        await fs.rm(path.join(projectRoot, SKILLS_DIR), { recursive: true, force: true });
+    }
+}
+export function createProviderScaffolder() {
+    return new OpenAiCodexProviderScaffolder();
+}
+//# sourceMappingURL=providerScaffolder.js.map

package/dist/providers/adapters/openai-codex/integration/providerScaffolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerScaffolder.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/integration/providerScaffolder.ts"],"names":[],"mappings":"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"}

package/dist/providers/adapters/openai-codex/integration/sessionResumeIndex.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SessionResumeIndex implementation for openai-codex.
+ *
+ * Codex rollouts live at $CODEX_HOME/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl
+ * with a SQLite index at `sqlite_home` (per the deep-dive). This adapter
+ * walks the filesystem directly; the SQLite index is a Phase 5 optimization.
+ *
+ * `codex resume --last` / `codex resume --all` are the CLI-side picker
+ * surfaces; this primitive exposes a programmatic equivalent.
+ */
+import type { SessionResumeIndex } from '../../../primitives/integration/sessionResumeIndex.js';
+import type { OpenAiCodexConfig } from '../config.js';
+export declare function createSessionResumeIndex(config: OpenAiCodexConfig): SessionResumeIndex;
+//# sourceMappingURL=sessionResumeIndex.d.ts.map

package/dist/providers/adapters/openai-codex/integration/sessionResumeIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionResumeIndex.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/integration/sessionResumeIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,uDAAuD,CAAC;AAM/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAiGtD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,CAEtF"}