humanish 0.0.1 → 0.15.1

package/dist/codex-app-server-ui.js

@@ -0,0 +1,357 @@
+import { createServer } from "node:http";
+import path from "node:path";
+import { runCodexAppServerSessionInPreparedRoot } from "./codex-app-server.js";
+import { prepareContainedOutputDirectory, prepareContainedOutputFile, prepareManagedHumanishOutputDirectory, prepareSelectedOutputDirectory, prepareSelectedOutputFile, readContainedRegularFile, writeContainedOutputFile, writePreparedSelectedOutputFile } from "./selected-output-paths.js";
+export const CODEX_APP_SERVER_UI_SCHEMA = "humanish.codex-app-server-ui.v1";
+export async function startCodexAppServerUi(options) {
+    const cwd = path.resolve(options.cwd);
+    const preparedRunRoot = options.runRoot === undefined
+        ? await prepareManagedHumanishOutputDirectory(cwd, "codex-app-server-ui")
+        : await prepareSelectedOutputDirectory(cwd, options.runRoot);
+    const preparedStateFile = options.stateFile === undefined
+        ? undefined
+        : await prepareSelectedOutputFile(cwd, options.stateFile);
+    const stateFile = preparedStateFile?.requestedPath ?? path.join(preparedRunRoot.requestedPath, "state.json");
+    if (!preparedStateFile) {
+        await prepareContainedOutputFile(preparedRunRoot, "state.json");
+    }
+    await prepareContainedOutputDirectory(preparedRunRoot, "codex-app-server");
+    await Promise.all([
+        prepareContainedOutputFile(preparedRunRoot, path.join("codex-app-server", "events.ndjson")),
+        prepareContainedOutputFile(preparedRunRoot, path.join("codex-app-server", "summary.json")),
+        prepareContainedOutputFile(preparedRunRoot, path.join("codex-app-server", "transcript.txt"))
+    ]);
+    const publicRunRoot = path.relative(cwd, preparedRunRoot.requestedPath) || ".";
+    const publicStateFile = path.relative(cwd, stateFile) || path.basename(stateFile);
+    let state = {
+        schema: CODEX_APP_SERVER_UI_SCHEMA,
+        artifactRoot: publicRunRoot,
+        cwd: "[target-cwd]",
+        promptDigest: digestText(options.prompt),
+        reason: "Codex app-server UI is starting.",
+        runRoot: publicRunRoot,
+        startedAt: new Date().toISOString(),
+        status: "starting",
+        stateFile: publicStateFile,
+        updatedAt: new Date().toISOString()
+    };
+    const persistState = async () => {
+        const contents = `${JSON.stringify(state, null, 2)}\n`;
+        if (preparedStateFile) {
+            await writePreparedSelectedOutputFile(preparedStateFile, contents, "utf8");
+        }
+        else {
+            await writeContainedOutputFile(preparedRunRoot, "state.json", contents, "utf8");
+        }
+    };
+    const server = createServer(async (request, response) => {
+        if (request.url === "/state") {
+            response.writeHead(200, {
+                "cache-control": "no-store",
+                "content-type": "application/json; charset=utf-8"
+            });
+            response.end(`${JSON.stringify(state)}\n`);
+            return;
+        }
+        if (request.url?.startsWith("/artifact/")) {
+            let requestPath;
+            try {
+                requestPath = decodeURIComponent(request.url.slice("/artifact/".length));
+            }
+            catch {
+                response.writeHead(404);
+                response.end("not found");
+                return;
+            }
+            await serveArtifact({
+                requestPath,
+                response,
+                runRoot: preparedRunRoot
+            });
+            return;
+        }
+        response.writeHead(200, {
+            "cache-control": "no-store",
+            "content-type": "text/html; charset=utf-8"
+        });
+        response.end(renderCodexAppServerUiHtml());
+    });
+    const url = await listen(server, options.port ?? 0);
+    state = {
+        ...state,
+        reason: "Codex app-server actor is running.",
+        status: "running",
+        updatedAt: new Date().toISOString(),
+        url
+    };
+    try {
+        await persistState();
+    }
+    catch (error) {
+        await closeServer(server);
+        throw error;
+    }
+    const sessionOptions = {
+        cwd,
+        prompt: options.prompt,
+        runRoot: preparedRunRoot.physicalPath,
+        timeoutMs: options.timeoutMs,
+        ...(options.actorCommand ? { actorCommand: ["bash", "-lc", options.actorCommand] } : {}),
+        approvalPolicy: "never",
+        experimentalApi: true,
+        ...(options.model === undefined ? {} : { model: options.model }),
+        sandbox: options.sandbox ?? "read-only",
+        serviceName: options.serviceName ?? "humanish"
+    };
+    const completion = runCodexAppServerSessionInPreparedRoot(sessionOptions, preparedRunRoot).then(async (result) => {
+        state = {
+            ...state,
+            reason: result.reason,
+            result,
+            status: result.status,
+            updatedAt: new Date().toISOString()
+        };
+        try {
+            await persistState();
+        }
+        catch (error) {
+            await closeServer(server);
+            throw error;
+        }
+        if (options.keepOpen !== true) {
+            await closeServer(server);
+        }
+        return state;
+    }, async (error) => {
+        state = {
+            ...state,
+            reason: error instanceof Error ? error.message : String(error),
+            status: "blocked",
+            updatedAt: new Date().toISOString()
+        };
+        try {
+            await persistState();
+        }
+        catch (persistError) {
+            await closeServer(server);
+            throw persistError;
+        }
+        await closeServer(server);
+        return state;
+    });
+    return {
+        close: async () => closeServer(server),
+        completion,
+        initialState: state,
+        stateFile,
+        url
+    };
+}
+async function serveArtifact(args) {
+    const body = await readContainedRegularFile(args.runRoot, args.requestPath);
+    if (body) {
+        args.response.writeHead(200, {
+            "cache-control": "no-store",
+            "content-type": contentTypeFor(args.requestPath)
+        });
+        args.response.end(body);
+        return;
+    }
+    args.response.writeHead(404);
+    args.response.end("not found");
+}
+function contentTypeFor(filePath) {
+    if (filePath.endsWith(".json"))
+        return "application/json; charset=utf-8";
+    if (filePath.endsWith(".ndjson"))
+        return "application/x-ndjson; charset=utf-8";
+    return "text/plain; charset=utf-8";
+}
+async function listen(server, port) {
+    return new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(port, "127.0.0.1", () => {
+            server.off("error", reject);
+            const address = server.address();
+            if (!address || typeof address === "string") {
+                reject(new Error("Codex app-server UI address was unavailable."));
+                return;
+            }
+            resolve(`http://127.0.0.1:${address.port}/`);
+        });
+    });
+}
+async function closeServer(server) {
+    if (!server.listening) {
+        return;
+    }
+    await new Promise((resolve, reject) => {
+        server.close((error) => {
+            if (error)
+                reject(error);
+            else
+                resolve();
+        });
+    });
+}
+function digestText(text) {
+    let hash = 0x811c9dc5;
+    for (const char of text) {
+        hash ^= char.charCodeAt(0);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, "0");
+}
+function renderCodexAppServerUiHtml() {
+    return `<!doctype html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Humanish Codex App-Server</title>
+  <style>
+    :root {
+      --bg: #080a0d;
+      --surface: #11151b;
+      --surface-2: #171d25;
+      --line: rgba(255,255,255,.1);
+      --line-2: rgba(255,255,255,.16);
+      --text: #eef2f7;
+      --muted: #9aa4b2;
+      --dim: #687281;
+      --accent: #5f82ff;
+      --green: #38d890;
+      --red: #ff6258;
+      --amber: #f2b84a;
+      color-scheme: dark;
+      font-family: "Geist", ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    }
+    * { box-sizing: border-box; }
+    body { margin: 0; background: var(--bg); color: var(--text); min-height: 100vh; }
+    .shell { min-height: 100vh; display: grid; grid-template-rows: auto 1fr; }
+    header { display: flex; align-items: center; gap: 14px; padding: 14px 16px; border-bottom: 1px solid var(--line); background: rgba(17,21,27,.95); position: sticky; top: 0; }
+    .mark { width: 34px; height: 34px; border-radius: 10px; display: grid; place-items: center; border: 1px solid var(--line-2); background: radial-gradient(circle at 25% 20%, rgba(95,130,255,.4), transparent 65%), var(--surface-2); color: #c9d6ff; font-weight: 700; }
+    .title { min-width: 0; }
+    .title h1 { margin: 0; font-size: 15px; line-height: 1.2; letter-spacing: 0; }
+    .title p { margin: 2px 0 0; color: var(--muted); font-size: 12px; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; max-width: 74vw; }
+    .pill { margin-left: auto; border: 1px solid var(--line-2); border-radius: 999px; padding: 7px 11px; color: var(--muted); background: var(--surface-2); font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 11px; text-transform: uppercase; letter-spacing: .12em; }
+    .pill[data-status="passed"] { color: var(--green); border-color: rgba(56,216,144,.35); background: rgba(56,216,144,.12); }
+    .pill[data-status="failed"], .pill[data-status="blocked"], .pill[data-status="timed_out"] { color: var(--red); border-color: rgba(255,98,88,.35); background: rgba(255,98,88,.12); }
+    main { display: grid; grid-template-columns: 300px 1fr; min-height: 0; }
+    aside { border-right: 1px solid var(--line); padding: 14px; background: #0c1015; min-width: 0; }
+    section { padding: 14px; min-width: 0; overflow: auto; }
+    .label { color: var(--dim); text-transform: uppercase; letter-spacing: .16em; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 10px; margin: 16px 0 7px; }
+    .kv { display: grid; grid-template-columns: 76px 1fr; gap: 7px; padding: 7px 0; border-bottom: 1px solid var(--line); color: var(--muted); font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 11px; }
+    .kv b { color: var(--text); font-weight: 500; overflow-wrap: anywhere; }
+    .grid { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 10px; margin-bottom: 14px; }
+    .metric { border: 1px solid var(--line); background: var(--surface); border-radius: 10px; padding: 12px; min-height: 72px; }
+    .metric span { color: var(--dim); font-family: ui-monospace, SFMono-Regular, Menlo, monospace; text-transform: uppercase; letter-spacing: .12em; font-size: 10px; }
+    .metric strong { display: block; margin-top: 5px; font-size: 22px; }
+    .panel { border: 1px solid var(--line); background: var(--surface); border-radius: 12px; margin-bottom: 12px; overflow: hidden; }
+    .panel h2 { margin: 0; padding: 11px 12px; font-size: 13px; border-bottom: 1px solid var(--line); }
+    .panel pre, .panel .empty { margin: 0; padding: 12px; color: var(--muted); white-space: pre-wrap; overflow-wrap: anywhere; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 12px; line-height: 1.55; max-height: 280px; overflow: auto; }
+    .item { padding: 10px 12px; border-bottom: 1px solid var(--line); }
+    .item:last-child { border-bottom: none; }
+    .item b { display: block; font-size: 12px; margin-bottom: 3px; }
+    .item code { color: var(--muted); font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 11px; overflow-wrap: anywhere; }
+    a { color: #b9c9ff; text-decoration: none; }
+    @media (max-width: 860px) {
+      main { grid-template-columns: 1fr; }
+      aside { border-right: 0; border-bottom: 1px solid var(--line); }
+      .grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+    }
+  </style>
+</head>
+<body>
+  <div class="shell">
+    <header>
+      <div class="mark">CT</div>
+      <div class="title">
+        <h1>Codex App-Server Actor</h1>
+        <p id="subtitle">Connecting to Humanish state...</p>
+      </div>
+      <div class="pill" id="status" data-status="starting">STARTING</div>
+    </header>
+    <main>
+      <aside>
+        <div class="label">Session</div>
+        <div class="kv"><span>Status</span><b id="side-status">starting</b></div>
+        <div class="kv"><span>Thread</span><b id="thread">pending</b></div>
+        <div class="kv"><span>Turn</span><b id="turn">pending</b></div>
+        <div class="kv"><span>Model</span><b id="model">pending</b></div>
+        <div class="kv"><span>Digest</span><b id="digest">pending</b></div>
+        <div class="label">Artifacts</div>
+        <div id="artifacts"></div>
+      </aside>
+      <section>
+        <div class="grid" id="metrics"></div>
+        <div class="panel"><h2>Latest Agent Message</h2><pre id="message">(waiting)</pre></div>
+        <div class="panel"><h2>Reasoning Summary</h2><pre id="reasoning">(waiting)</pre></div>
+        <div class="panel"><h2>Commands</h2><div id="commands" class="empty">(waiting)</div></div>
+        <div class="panel"><h2>Approvals</h2><div id="approvals" class="empty">(none)</div></div>
+      </section>
+    </main>
+  </div>
+  <script>
+    function esc(value) {
+      return String(value == null ? "" : value).replace(/[&<>"']/g, function(ch) {
+        return ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", "\\"": "&quot;", "'": "&#39;" })[ch];
+      });
+    }
+    function latestText(items) {
+      if (!Array.isArray(items) || !items.length) return "(waiting)";
+      return items[items.length - 1].text || "(empty)";
+    }
+    function renderItems(items, empty, map) {
+      if (!Array.isArray(items) || !items.length) return '<div class="empty">' + esc(empty) + '</div>';
+      return items.map(map).join("");
+    }
+    async function tick() {
+      try {
+        var response = await fetch("/state", { cache: "no-store" });
+        var state = await response.json();
+        var trace = state.result && state.result.trace ? state.result.trace : {};
+        var counts = trace.counts || {};
+        document.getElementById("status").textContent = String(state.status || "unknown").toUpperCase();
+        document.getElementById("status").dataset.status = state.status || "unknown";
+        document.getElementById("side-status").textContent = state.status || "unknown";
+        document.getElementById("subtitle").textContent = state.reason || state.url || "";
+        document.getElementById("thread").textContent = trace.threadId || state.result?.threadId || "pending";
+        document.getElementById("turn").textContent = trace.turnId || state.result?.turnId || "pending";
+        document.getElementById("model").textContent = trace.model || state.result?.model || "pending";
+        document.getElementById("digest").textContent = state.promptDigest || "pending";
+        var metricDefs = [
+          ["Messages", counts.messages || 0],
+          ["Reasoning", counts.reasoning || 0],
+          ["Commands", counts.commandOutputs || 0],
+          ["Envelopes", counts.envelopes || 0]
+        ];
+        document.getElementById("metrics").innerHTML = metricDefs.map(function(entry) {
+          return '<div class="metric"><span>' + esc(entry[0]) + '</span><strong>' + esc(entry[1]) + '</strong></div>';
+        }).join("");
+        document.getElementById("message").textContent = latestText(trace.messages);
+        document.getElementById("reasoning").textContent = latestText(trace.reasoning);
+        document.getElementById("commands").innerHTML = renderItems(trace.commands, "(waiting)", function(command) {
+          return '<div class="item"><b>' + esc(command.command || "command") + '</b><code>' + esc(command.status || "") + " " + esc(command.outputTail || "") + '</code></div>';
+        });
+        document.getElementById("approvals").innerHTML = renderItems(trace.approvals, "(none)", function(approval) {
+          return '<div class="item"><b>' + esc(approval.method || "approval") + '</b><code>' + esc(approval.decision || "") + " " + esc(approval.reason || "") + '</code></div>';
+        });
+        var artifacts = [];
+        if (state.result?.tracePath) artifacts.push(["Trace", state.result.tracePath]);
+        if (state.result?.eventsPath) artifacts.push(["Events", state.result.eventsPath]);
+        if (state.result?.transcriptPath) artifacts.push(["Transcript", state.result.transcriptPath]);
+        document.getElementById("artifacts").innerHTML = artifacts.length
+          ? artifacts.map(function(entry) { return '<div class="item"><b>' + esc(entry[0]) + '</b><code><a href="/artifact/' + encodeURIComponent(entry[1]) + '">' + esc(entry[1]) + '</a></code></div>'; }).join("")
+          : '<div class="empty">Artifacts will appear after completion.</div>';
+      } catch (error) {
+        document.getElementById("subtitle").textContent = "State polling failed: " + error.message;
+      }
+    }
+    tick();
+    setInterval(tick, 1000);
+  </script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=codex-app-server-ui.js.map

package/dist/codex-app-server-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-app-server-ui.js","sourceRoot":"","sources":["../src/codex-app-server-ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoC,MAAM,WAAW,CAAC;AAC3E,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,sCAAsC,EAIvC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,qCAAqC,EACrC,8BAA8B,EAC9B,yBAAyB,EACzB,wBAAwB,EAGxB,wBAAwB,EACxB,+BAA+B,EAChC,MAAM,4BAA4B,CAAC;AAEpC,MAAM,CAAC,MAAM,0BAA0B,GAAG,iCAAiC,CAAC;AAyC5E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAgC;IAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS;QACnD,CAAC,CAAC,MAAM,qCAAqC,CAAC,GAAG,EAAE,qBAAqB,CAAC;QACzE,CAAC,CAAC,MAAM,8BAA8B,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,iBAAiB,GAA2C,OAAO,CAAC,SAAS,KAAK,SAAS;QAC/F,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,yBAAyB,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,iBAAiB,EAAE,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC7G,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,0BAA0B,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,+BAA+B,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;IAC3E,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,0BAA0B,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;QAC3F,0BAA0B,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC;QAC1F,0BAA0B,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;KAC7F,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC;IAC/E,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAElF,IAAI,KAAK,GAA0B;QACjC,MAAM,EAAE,0BAA0B;QAClC,YAAY,EAAE,aAAa;QAC3B,GAAG,EAAE,cAAc;QACnB,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;QACxC,MAAM,EAAE,kCAAkC;QAC1C,OAAO,EAAE,aAAa;QACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,eAAe;QAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,MAAM,YAAY,GAAG,KAAK,IAAmB,EAAE;QAC7C,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QACvD,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,+BAA+B,CAAC,iBAAiB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACN,MAAM,wBAAwB,CAAC,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClF,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QACtD,IAAI,OAAO,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC7B,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;gBACtB,eAAe,EAAE,UAAU;gBAC3B,cAAc,EAAE,iCAAiC;aAClD,CAAC,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC1C,IAAI,WAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3E,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACxB,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,MAAM,aAAa,CAAC;gBAClB,WAAW;gBACX,QAAQ;gBACR,OAAO,EAAE,eAAe;aACzB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;YACtB,eAAe,EAAE,UAAU;YAC3B,cAAc,EAAE,0BAA0B;SAC3C,CAAC,CAAC;QACH,QAAQ,CAAC,GAAG,CAAC,0BAA0B,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IACpD,KAAK,GAAG;QACN,GAAG,KAAK;QACR,MAAM,EAAE,oCAAoC;QAC5C,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG;KACJ,CAAC;IACF,IAAI,CAAC;QACH,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,cAAc,GAA6B;QAC/C,GAAG;QACH,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,eAAe,CAAC,YAAY;QACrC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,cAAc,EAAE,OAAO;QACvB,eAAe,EAAE,IAAI;QACrB,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAChE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,WAAW;QACvC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,UAAU;KAC/C,CAAC;IACF,MAAM,UAAU,GAAG,sCAAsC,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,IAAI,CAC7F,KAAK,EAAE,MAAM,EAAkC,EAAE;QAC/C,KAAK,GAAG;YACN,GAAG,KAAK;YACR,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM;YACN,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,YAAY,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,EACD,KAAK,EAAE,KAAc,EAAkC,EAAE;QACvD,KAAK,GAAG;YACN,GAAG,KAAK;YACR,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC9D,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,YAAY,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,YAAY,EAAE,CAAC;YACtB,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,YAAY,CAAC;QACrB,CAAC;QACD,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC,CACF,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;QACtC,UAAU;QACV,YAAY,EAAE,KAAK;QACnB,SAAS;QACT,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAI5B;IACC,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5E,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;YAC3B,eAAe,EAAE,UAAU;YAC3B,cAAc,EAAE,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC;SACjD,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,iCAAiC,CAAC;IACzE,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,qCAAqC,CAAC;IAC/E,OAAO,2BAA2B,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,MAAc,EAAE,IAAY;IAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;YACpC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC,CAAC;gBAClE,OAAO;YACT,CAAC;YACD,OAAO,CAAC,oBAAoB,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,MAAc;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACrB,IAAI,KAAK;gBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;gBACpB,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,0BAA0B;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqJD,CAAC;AACT,CAAC"}

package/dist/codex-app-server.d.ts

@@ -0,0 +1,144 @@
+import { type PreparedOutputDirectory } from "./selected-output-paths.js";
+export declare const CODEX_APP_SERVER_TRACE_SCHEMA = "humanish.codex-app-server-trace.v1";
+type JsonObject = Record<string, unknown>;
+type JsonRpcId = number | string;
+export type CodexAppServerStatus = "passed" | "failed" | "blocked" | "timed_out";
+export interface CodexAppServerRunOptions {
+    cwd: string;
+    prompt: string;
+    runRoot: string;
+    timeoutMs: number;
+    actorCommand?: string[];
+    approvalPolicy?: "never" | "on-failure" | "on-request" | "untrusted";
+    experimentalApi?: boolean;
+    model?: string;
+    sandbox?: "read-only" | "workspace-write" | "danger-full-access";
+    serviceName?: string;
+}
+export interface CodexAppServerRunResult {
+    status: CodexAppServerStatus;
+    reason: string;
+    durationMs: number;
+    exitCode?: number;
+    signal?: NodeJS.Signals;
+    threadId?: string;
+    turnId?: string;
+    sessionId?: string;
+    model?: string;
+    codexCliVersion?: string;
+    experimentalApi: boolean;
+    counts: CodexAppServerTrace["counts"];
+    tail: string;
+    trace: CodexAppServerTrace;
+    transcriptPath: string;
+    tracePath: string;
+    eventsPath: string;
+}
+export interface CodexAppServerTrace {
+    schema: typeof CODEX_APP_SERVER_TRACE_SCHEMA;
+    provider: "codex-app-server";
+    protocolVersion: "v2";
+    redaction: {
+        status: "passed";
+        notes: string;
+    };
+    client: {
+        name: "humanish_cli";
+        title: "Humanish CLI";
+        experimentalApi: boolean;
+    };
+    server: {
+        commandName: string;
+        codexCliVersion?: string;
+        transport: "stdio";
+    };
+    cwd: string;
+    promptDigest: string;
+    startedAt: string;
+    completedAt: string;
+    durationMs: number;
+    status: CodexAppServerStatus;
+    reason: string;
+    threadId?: string;
+    turnId?: string;
+    sessionId?: string;
+    model?: string;
+    counts: {
+        approvals: number;
+        commandOutputs: number;
+        envelopes: number;
+        errors: number;
+        fileChanges: number;
+        itemCompletions: number;
+        itemStarts: number;
+        messages: number;
+        reasoning: number;
+        requests: number;
+        responses: number;
+        tools: number;
+        warnings: number;
+    };
+    methods: Record<string, number>;
+    items: CodexTraceItem[];
+    messages: CodexTraceText[];
+    reasoning: CodexTraceText[];
+    plans: CodexTracePlan[];
+    commands: CodexTraceCommand[];
+    fileChanges: CodexTraceFileChange[];
+    tools: CodexTraceToolCall[];
+    approvals: CodexTraceApproval[];
+    warnings: CodexTraceNotice[];
+    errors: CodexTraceNotice[];
+    tokenUsage?: JsonObject;
+}
+export interface CodexTraceItem {
+    id: string;
+    type: string;
+    status?: string;
+    lifecycle: "started" | "completed";
+    title: string;
+}
+export interface CodexTraceText {
+    itemId: string;
+    text: string;
+}
+export interface CodexTracePlan {
+    explanation?: string;
+    steps: string[];
+}
+export interface CodexTraceCommand {
+    itemId: string;
+    command?: string;
+    cwd?: string;
+    status?: string;
+    exitCode?: number;
+    outputTail?: string;
+}
+export interface CodexTraceFileChange {
+    itemId: string;
+    status?: string;
+    changeCount?: number;
+    outputTail?: string;
+}
+export interface CodexTraceToolCall {
+    itemId: string;
+    kind: "mcp" | "dynamic" | "unknown";
+    server?: string;
+    tool?: string;
+    status?: string;
+}
+export interface CodexTraceApproval {
+    id: JsonRpcId;
+    method: string;
+    itemId?: string;
+    decision: "decline" | "denied" | "empty";
+    reason: string;
+}
+export interface CodexTraceNotice {
+    method: string;
+    message: string;
+}
+export declare function runCodexAppServerSession(options: CodexAppServerRunOptions): Promise<CodexAppServerRunResult>;
+/** Internal UI seam: the selected root was already prepared and must not be re-authorized. */
+export declare function runCodexAppServerSessionInPreparedRoot(options: CodexAppServerRunOptions, runRoot: PreparedOutputDirectory): Promise<CodexAppServerRunResult>;
+export {};