dores-codex 4.0.0

package/lib/startup-hook.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+import {
+  buildHookPayload,
+  dispatchHookEvent,
+  readHookInput
+} from "./hook-shared.js";
+
+const label = "startup-hook";
+const hookData = await readHookInput(label);
+const source = String(hookData?.source ?? "").trim().toLowerCase();
+const payload = buildHookPayload(hookData, {
+  start_source: source || null,
+  status: source === "resume" ? "resumed" : "in_progress"
+});
+
+process.exit(
+  await dispatchHookEvent(label, hookData, {
+    extraPayload: payload
+  })
+);

package/lib/stop-hook.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+import {
+  buildHookPayload,
+  dispatchHookEvent,
+  readHookInput
+} from "./hook-shared.js";
+
+const label = "stop-hook";
+const hookData = await readHookInput(label);
+const reasonText = String(
+  hookData?.reason ?? hookData?.message ?? hookData?.status ?? ""
+).trim();
+const normalizedReason = reasonText.toLowerCase();
+const lastAssistantMessage =
+  String(hookData?.last_assistant_message ?? "").trim() || null;
+const looksInterrupted =
+  normalizedReason.includes("interrupted") ||
+  normalizedReason.includes("cancelled") ||
+  normalizedReason.includes("canceled") ||
+  normalizedReason.includes("aborted");
+const payload = buildHookPayload(hookData, {
+  last_assistant_message: lastAssistantMessage,
+  reason: reasonText || null,
+  status: looksInterrupted
+    ? "interrupted"
+    : lastAssistantMessage
+      ? "completed"
+      : "stopped",
+  stop_hook_active:
+    typeof hookData?.stop_hook_active === "boolean" ? hookData.stop_hook_active : null
+});
+
+process.exit(
+  await dispatchHookEvent(label, hookData, {
+    extraPayload: payload
+  })
+);

package/lib/uninstall-hooks.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+const MANAGED_STATUS_PREFIX = "dores-codex:";
+const DEFAULT_CODEX_HOME = path.join(os.homedir(), ".codex");
+
+function resolveCodexHome() {
+  const explicit = (process.env.CODEX_PLUGIN_CODEX_HOME ?? "").trim();
+  return path.resolve(explicit || DEFAULT_CODEX_HOME);
+}
+
+function resolveHooksFile(codexHome) {
+  return path.join(codexHome, "hooks.json");
+}
+
+function readJsonFile(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  const text = fs.readFileSync(filePath, "utf8");
+  if (!text.trim()) {
+    return null;
+  }
+
+  return JSON.parse(text);
+}
+
+function isManagedGroup(group) {
+  return Array.isArray(group?.hooks) && group.hooks.some((hook) => {
+    const statusMessage = typeof hook?.statusMessage === "string" ? hook.statusMessage : "";
+    return statusMessage.startsWith(MANAGED_STATUS_PREFIX);
+  });
+}
+
+function main() {
+  const codexHome = resolveCodexHome();
+  const hooksFile = resolveHooksFile(codexHome);
+  const hooksDoc = readJsonFile(hooksFile);
+
+  if (!hooksDoc || typeof hooksDoc !== "object" || Array.isArray(hooksDoc)) {
+    console.log(`[codex-plugin-uninstall] no managed hooks found at ${hooksFile}`);
+    return;
+  }
+
+  if (!hooksDoc.hooks || typeof hooksDoc.hooks !== "object" || Array.isArray(hooksDoc.hooks)) {
+    console.log(`[codex-plugin-uninstall] no managed hooks found at ${hooksFile}`);
+    return;
+  }
+
+  let removedGroups = 0;
+  for (const [eventName, groups] of Object.entries(hooksDoc.hooks)) {
+    if (!Array.isArray(groups)) {
+      continue;
+    }
+
+    const filteredGroups = groups.filter((group) => !isManagedGroup(group));
+    removedGroups += groups.length - filteredGroups.length;
+
+    if (filteredGroups.length > 0) {
+      hooksDoc.hooks[eventName] = filteredGroups;
+    } else {
+      delete hooksDoc.hooks[eventName];
+    }
+  }
+
+  if (removedGroups === 0) {
+    console.log(`[codex-plugin-uninstall] no managed hooks found at ${hooksFile}`);
+    return;
+  }
+
+  if (Object.keys(hooksDoc.hooks).length === 0) {
+    fs.unlinkSync(hooksFile);
+  } else {
+    fs.writeFileSync(hooksFile, `${JSON.stringify(hooksDoc, null, 2)}\n`, "utf8");
+  }
+
+  console.log(`[codex-plugin-uninstall] removed ${removedGroups} managed hook group(s).`);
+  console.log(`[codex-plugin-uninstall] hooks file: ${hooksFile}`);
+  console.log(
+    "[codex-plugin-uninstall] codex_hooks in config.toml was left unchanged."
+  );
+}
+
+main();

package/lib/user-prompt-submit-hook.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+import {
+  buildHookPayload,
+  dispatchHookEvent,
+  readHookInput
+} from "./hook-shared.js";
+
+const label = "user-prompt-submit-hook";
+const hookData = await readHookInput(label);
+const payload = buildHookPayload(hookData, {
+  input_text: String(hookData?.prompt ?? hookData?.input_text ?? "").trim() || null,
+  status: "in_progress"
+});
+
+process.exit(
+  await dispatchHookEvent(label, hookData, {
+    extraPayload: payload
+  })
+);

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "dores-codex",
+  "version": "4.0.0",
+  "description": "Forward official Codex hook events to a websocket endpoint.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "bin": {
+    "codex-plugin-setup": "./codex-plugin-setup",
+    "codex-plugin-uninstall": "./codex-plugin-uninstall"
+  },
+  "files": [
+    ".codex",
+    "lib",
+    "install.sh",
+    "uninstall.sh",
+    "codex-plugin-setup",
+    "codex-plugin-uninstall",
+    "README.md",
+    "INSTALL.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "keywords": [
+    "codex",
+    "openai",
+    "cli",
+    "hooks"
+  ],
+  "scripts": {
+    "check": "node --check ./lib/client-event.js && node --check ./lib/dores-client.js && node --check ./lib/hook-shared.js && node --check ./lib/hook-runner.js && node --check ./lib/setup-hooks.js && node --check ./lib/uninstall-hooks.js && node --check ./lib/startup-hook.js && node --check ./lib/user-prompt-submit-hook.js && node --check ./lib/pre-tool-use-hook.js && node --check ./lib/post-tool-use-hook.js && node --check ./lib/stop-hook.js && bash -n ./install.sh ./uninstall.sh ./codex-plugin-setup ./codex-plugin-uninstall ./.codex/bin/dores-hook-dispatch",
+    "pack": "npm pack",
+    "pack:dry-run": "env npm_config_cache=${TMPDIR:-/tmp}/dores-codex-npm-cache npm pack --dry-run"
+  }
+}

package/uninstall.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec node "$script_dir/lib/uninstall-hooks.js" "$@"