approval-md 0.0.1 → 0.1.0

package/dist/src/cli/gloss-codex.js

@@ -0,0 +1,255 @@
+/** Provider-specific Codex CLI runner for optional model glosses (APRV-254). */
+import { spawnSync } from "node:child_process";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { childEnvironment } from "../core/child-env.js";
+import { GLOSS_EDIT_INSTRUCTION, GLOSS_EMAIL_INSTRUCTION, GLOSS_INSTRUCTION, GLOSS_MAX_INPUT_CHARS, GLOSS_TRUNCATION_NOTE, GLOSS_TIMEOUT_MS, normalizeGlossModelId, } from "./gloss.js";
+const OUTPUT_LIMIT_BYTES = 64 * 1024;
+const HELPER_PATH = fileURLToPath(new URL("./gloss-codex-child.js", import.meta.url));
+const SUPERVISOR_GRACE_MS = 250;
+const CODEX_ENABLED_FEATURES = ["skip_host_skill_discovery"];
+const CODEX_DISABLED_FEATURES = [
+    "apps",
+    "auth_elicitation",
+    "browser_use",
+    "browser_use_external",
+    "browser_use_full_cdp_access",
+    "code_mode",
+    "code_mode_host",
+    "computer_use",
+    "goals",
+    "hooks",
+    "image_generation",
+    "in_app_browser",
+    "in_app_local_automation",
+    "memories",
+    "multi_agent",
+    "multi_agent_v2",
+    "plugins",
+    "remote_plugin",
+    "skill_mcp_dependency_install",
+    "skill_search",
+    "shell_tool",
+    "sleep_tool",
+    "tool_call_mcp_elicitation",
+    "tool_suggest",
+    "unified_exec",
+    "view_image",
+    "workspace_dependencies",
+];
+const CODEX_CONFIG = [
+    'project_doc_max_bytes=0',
+    'project_doc_fallback_filenames=[]',
+    'project_root_markers=[]',
+    // Enabling skip_host_skill_discovery otherwise emits Codex's known
+    // under-development-feature notice as an error item before the turn. This
+    // suppresses that startup notice only; every emitted JSONL error remains a
+    // hard failure in parseSuccessfulAnswer.
+    'suppress_unstable_features_warning=true',
+    'approval_policy="never"',
+    'default_permissions="gloss"',
+    'permissions.gloss.filesystem={":minimal"="read",":workspace_roots"={"."="read"}}',
+    'permissions.gloss.network.enabled=false',
+    'web_search="disabled"',
+    'mcp_servers={}',
+    'hooks={}',
+    'plugins={}',
+    'history.persistence="none"',
+    'check_for_update_on_startup=false',
+    'analytics.enabled=false',
+    'otel.exporter="none"',
+    'notify=[]',
+];
+const KNOWN_INSTRUCTIONS = new Set([
+    GLOSS_INSTRUCTION,
+    GLOSS_EDIT_INSTRUCTION,
+    GLOSS_EMAIL_INSTRUCTION,
+]);
+function report(options, reason) {
+    try {
+        options.diagnostic?.(reason);
+    }
+    catch {
+        // Diagnostics cannot make a reading aid load-bearing.
+    }
+    return null;
+}
+function splitPrompt(prompt) {
+    const separator = prompt.indexOf("\n\n");
+    if (separator < 0)
+        return null;
+    const instruction = prompt.slice(0, separator);
+    if (!KNOWN_INSTRUCTIONS.has(instruction))
+        return null;
+    const material = prompt.slice(separator + 2);
+    const largestCappedMaterial = GLOSS_MAX_INPUT_CHARS + GLOSS_TRUNCATION_NOTE.length + 2;
+    if (material.length > largestCappedMaterial)
+        return null;
+    return { instruction, material };
+}
+function codexArgs(model, cwd) {
+    const args = [
+        "exec",
+        "--strict-config",
+        "--ignore-user-config",
+        "--ignore-rules",
+        "--ephemeral",
+        "--skip-git-repo-check",
+        "--json",
+        "-C",
+        cwd,
+        "-m",
+        model,
+    ];
+    for (const config of CODEX_CONFIG)
+        args.push("-c", config);
+    for (const feature of CODEX_ENABLED_FEATURES)
+        args.push("--enable", feature);
+    for (const feature of CODEX_DISABLED_FEATURES)
+        args.push("--disable", feature);
+    return args;
+}
+function object(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+function parseSuccessfulAnswer(stdout, model) {
+    let completedTurns = 0;
+    let answer = null;
+    let terminal = false;
+    const lines = stdout.split(/\r?\n/u).filter((line) => line.trim().length > 0);
+    if (lines.length === 0)
+        return null;
+    for (const line of lines) {
+        let event;
+        try {
+            event = object(JSON.parse(line));
+        }
+        catch {
+            return null;
+        }
+        if (event === null || typeof event.type !== "string")
+            return null;
+        if (terminal)
+            return null;
+        if (event.type === "thread.started" || event.type === "turn.started")
+            continue;
+        if (event.type === "error" || event.type === "turn.failed")
+            return null;
+        if (event.type === "turn.completed") {
+            completedTurns += 1;
+            terminal = true;
+            continue;
+        }
+        if (event.type !== "item.started" &&
+            event.type !== "item.updated" &&
+            event.type !== "item.completed") {
+            return null;
+        }
+        const item = object(event.item);
+        if (item === null || (item.type !== "reasoning" && item.type !== "agent_message")) {
+            return null;
+        }
+        if (event.type === "item.completed" && item.type === "agent_message") {
+            if (typeof item.text !== "string" || item.text.trim().length === 0)
+                return null;
+            answer = item.text;
+        }
+    }
+    return completedTurns === 1 && answer !== null
+        ? { text: answer, provenance: { provider: "codex", requestedModel: model } }
+        : null;
+}
+/**
+ * Build a synchronous Codex gloss runner using the CLI's saved authentication.
+ *
+ * The invocation starts in a new empty directory with a named read-only
+ * permission profile, command network disabled, project instructions
+ * suppressed, host skill discovery skipped, and selected known
+ * tool/integration features disabled.
+ * Codex 0.152.1 has no universal deny-all tool switch: host-managed and global
+ * base instructions still apply, the under-development discovery switch is
+ * version-specific, and the CLI owns any auth-state maintenance.
+ * The caller must present that practical isolation boundary to the operator.
+ */
+export function codexGlossRunnerFor(model, passphraseEnv = null, options = {}) {
+    const requestedModel = normalizeGlossModelId(model);
+    return (prompt) => {
+        if (requestedModel === null)
+            return report(options, "invalid-model");
+        if (process.platform === "win32")
+            return report(options, "unsupported-platform");
+        const parts = splitPrompt(prompt);
+        if (parts === null)
+            return report(options, "invalid-prompt");
+        const configuredTimeout = options.timeoutMs ?? GLOSS_TIMEOUT_MS;
+        const timeoutMs = Number.isSafeInteger(configuredTimeout) && configuredTimeout > 0
+            ? configuredTimeout
+            : GLOSS_TIMEOUT_MS;
+        let cwd;
+        try {
+            cwd = mkdtempSync(join(tmpdir(), "approval-md-codex-gloss-"));
+        }
+        catch {
+            return report(options, "spawn-error");
+        }
+        let answer = null;
+        let reason = null;
+        try {
+            const childDeadline = Math.max(1, timeoutMs - Math.min(SUPERVISOR_GRACE_MS, Math.floor(timeoutMs / 4)));
+            const result = spawnSync(process.execPath, [
+                HELPER_PATH,
+                options.executable ?? "codex",
+                String(childDeadline),
+                cwd,
+                parts.instruction,
+                JSON.stringify(codexArgs(requestedModel, cwd)),
+            ], {
+                encoding: "utf8",
+                env: childEnvironment({ passphraseEnv }).env,
+                input: parts.material,
+                timeout: timeoutMs,
+                killSignal: "SIGTERM",
+                maxBuffer: OUTPUT_LIMIT_BYTES,
+            });
+            if (result.error !== undefined) {
+                const code = result.error.code;
+                reason = code === "ETIMEDOUT" ? "timeout" : code === "ENOBUFS" ? "output-too-large" : "spawn-error";
+            }
+            else if (result.status === 124) {
+                reason = "timeout";
+            }
+            else if (result.status === 125) {
+                reason = "output-too-large";
+            }
+            else if (result.status === 126) {
+                reason = "spawn-error";
+            }
+            else if (result.status !== 0) {
+                reason = "nonzero-exit";
+            }
+            else if (typeof result.stdout !== "string") {
+                reason = "invalid-output";
+            }
+            else {
+                answer = parseSuccessfulAnswer(result.stdout, requestedModel);
+                if (answer === null)
+                    reason = "unsafe-output";
+            }
+        }
+        catch {
+            reason = "spawn-error";
+        }
+        try {
+            rmSync(cwd, { recursive: true, force: true });
+        }
+        catch {
+            return report(options, "cleanup-failed");
+        }
+        return reason === null ? answer : report(options, reason);
+    };
+}
+//# sourceMappingURL=gloss-codex.js.map

package/dist/src/cli/gloss-codex.js.map

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

package/dist/src/cli/gloss-options.js

@@ -0,0 +1,79 @@
+/** Shared provider selection for the three optional gloss surfaces (APRV-255). */
+import { boolFlag } from "./args.js";
+import { codexGlossRunnerFor } from "./gloss-codex.js";
+import { GLOSS_MODEL, GLOSS_MODEL_ID_MAX_CHARS, glossRunnerFor, normalizeGlossModelId, } from "./gloss.js";
+/**
+ * Resolve the flags shared by `up`, Telegram listen and the terminal channel.
+ *
+ * The caller supplies its historical default: Telegram and `up` pass `true`,
+ * while the terminal channel passes `false`. `--no-gloss` wins a tie so an
+ * explicit request to remove a model from the path can never accidentally
+ * spawn one. Provider and model values are validated even when disabled;
+ * otherwise a typo could wait unnoticed until a later invocation adds
+ * `--gloss`.
+ */
+export function parseGlossOptions(flags, enabledByDefault) {
+    const providerValue = flags["--gloss-provider"];
+    if (providerValue !== undefined &&
+        (typeof providerValue !== "string" ||
+            (providerValue !== "claude" && providerValue !== "codex"))) {
+        return {
+            ok: false,
+            message: `--gloss-provider expects claude or codex, got ${JSON.stringify(providerValue)}`,
+        };
+    }
+    const provider = providerValue ?? "claude";
+    const modelValue = flags["--gloss-model"];
+    if (modelValue !== undefined && typeof modelValue !== "string") {
+        return {
+            ok: false,
+            message: `--gloss-model expects a model identifier, got ${JSON.stringify(modelValue)}`,
+        };
+    }
+    if (provider === "codex" && modelValue === undefined) {
+        return {
+            ok: false,
+            message: "--gloss-provider codex requires --gloss-model <model>",
+        };
+    }
+    const model = normalizeGlossModelId(modelValue ?? GLOSS_MODEL);
+    if (model === null) {
+        return {
+            ok: false,
+            message: `--gloss-model expects a nonblank model identifier of at most ${GLOSS_MODEL_ID_MAX_CHARS} letters, numbers, or . _ : / + - characters`,
+        };
+    }
+    return {
+        ok: true,
+        options: {
+            enabled: !boolFlag(flags, "--no-gloss") &&
+                (boolFlag(flags, "--gloss") || enabledByDefault),
+            provider,
+            model,
+        },
+    };
+}
+/** Construct exactly the selected runner, or no runner when glossing is disabled. */
+export function glossRunnerFromOptions(selection, factoryOptions = {}) {
+    if (!selection.enabled)
+        return undefined;
+    const passphraseEnv = factoryOptions.passphraseEnv ?? null;
+    if (selection.provider === "claude") {
+        return (factoryOptions.claudeRunnerFor ?? glossRunnerFor)(passphraseEnv, selection.model);
+    }
+    const runnerFor = factoryOptions.codexRunnerFor ?? codexGlossRunnerFor;
+    const diagnostic = factoryOptions.diagnostic;
+    return runnerFor(selection.model, passphraseEnv, diagnostic === undefined
+        ? {}
+        : {
+            diagnostic: (reason) => {
+                try {
+                    diagnostic(reason);
+                }
+                catch {
+                    // Reporting an absent convenience cannot break prompt dispatch.
+                }
+            },
+        });
+}
+//# sourceMappingURL=gloss-options.js.map

package/dist/src/cli/gloss-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gloss-options.js","sourceRoot":"","sources":["../../../src/cli/gloss-options.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,EAAE,QAAQ,EAAoB,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAoC,MAAM,kBAAkB,CAAC;AACzF,OAAO,EACL,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,qBAAqB,GAGtB,MAAM,YAAY,CAAC;AAapB;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAkB,EAClB,gBAAyB;IAEzB,MAAM,aAAa,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAChD,IACE,aAAa,KAAK,SAAS;QAC3B,CAAC,OAAO,aAAa,KAAK,QAAQ;YAChC,CAAC,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,OAAO,CAAC,CAAC,EAC5D,CAAC;QACD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,iDAAiD,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE;SAC1F,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAkB,aAAa,IAAI,QAAQ,CAAC;IAE1D,MAAM,UAAU,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC/D,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,iDAAiD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE;SACvF,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,uDAAuD;SACjE,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,qBAAqB,CAAC,UAAU,IAAI,WAAW,CAAC,CAAC;IAC/D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EACL,gEAAgE,wBAAwB,8CAA8C;SACzI,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE;YACP,OAAO,EACL,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;gBAC9B,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,gBAAgB,CAAC;YAClD,QAAQ;YACR,KAAK;SACN;KACF,CAAC;AACJ,CAAC;AAgBD,qFAAqF;AACrF,MAAM,UAAU,sBAAsB,CACpC,SAAuB,EACvB,cAAc,GAA8B,EAAE;IAE9C,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,aAAa,GAAG,cAAc,CAAC,aAAa,IAAI,IAAI,CAAC;IAC3D,IAAI,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,CAAC,cAAc,CAAC,eAAe,IAAI,cAAc,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,cAAc,IAAI,mBAAmB,CAAC;IACvE,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC;IAC7C,OAAO,SAAS,CACd,SAAS,CAAC,KAAK,EACf,aAAa,EACb,UAAU,KAAK,SAAS;QACtB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;gBACrB,IAAI,CAAC;oBACH,UAAU,CAAC,MAAM,CAAC,CAAC;gBACrB,CAAC;gBAAC,MAAM,CAAC;oBACP,gEAAgE;gBAClE,CAAC;YACH,CAAC;SACF,CACN,CAAC;AACJ,CAAC"}