@elaraai/e3-cloud-codex-plugin 0.0.0-stage → 1.0.90-alpha.0

package/.build/hooks/codex-tools.js

@@ -0,0 +1,306 @@
+// ../../node_modules/.pnpm/@elaraai+east-plugin@1.0.90_typescript@5.9.3/node_modules/@elaraai/east-plugin/dist/lib/codex-hook.js
+import { readFile as readFile2 } from "node:fs/promises";
+import { existsSync, writeFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { tmpdir } from "node:os";
+import { join, resolve as resolve3 } from "node:path";
+
+// ../../node_modules/.pnpm/@elaraai+east-plugin@1.0.90_typescript@5.9.3/node_modules/@elaraai/east-plugin/dist/lib/codex-tools.js
+import { resolve } from "node:path";
+function patchFiles(command, cwd) {
+  const files = [];
+  let current;
+  for (const line of command.split(/\r?\n/)) {
+    const header = /^\*\*\* (Add|Update|Delete) File: (.+)$/.exec(line);
+    if (header) {
+      const path = resolve(cwd, header[2]);
+      current = { path, originalPath: path, code: "", deleted: header[1] === "Delete" };
+      files.push(current);
+    } else if (line.startsWith("*** Move to: ") && current) {
+      current.path = resolve(cwd, line.slice(13));
+    } else if (current && (line.startsWith("+") || line.startsWith(" "))) {
+      current.code += line.slice(1) + "\n";
+    }
+  }
+  return files;
+}
+function shellReadPaths(command, cwd) {
+  const paths = /* @__PURE__ */ new Set();
+  let dir = cwd;
+  for (const segment of command.split(/&&|;|\n|\|/)) {
+    const tokens = [...segment.matchAll(/"([^"\n]*)"|'([^'\n]*)'|([^\s]+)/g)].map((m) => m[1] ?? m[2] ?? m[3]);
+    if (tokens[0] === "cd" && tokens[1]) {
+      dir = resolve(dir, tokens[1]);
+      continue;
+    }
+    if (!["cat", "head", "tail", "sed", "rg", "grep", "less", "more"].includes(tokens[0] ?? ""))
+      continue;
+    for (const token of tokens.slice(1)) {
+      if (!token.startsWith("-") && !/[*?$`]/.test(token) && /\.(tsx?|js|py)$/.test(token))
+        paths.add(resolve(dir, token));
+    }
+  }
+  return [...paths];
+}
+
+// ../../node_modules/.pnpm/@elaraai+east-plugin@1.0.90_typescript@5.9.3/node_modules/@elaraai/east-plugin/dist/lib/bash-writes.js
+import { resolve as resolve2 } from "node:path";
+function isRealPath(token) {
+  if (token === "" || token.startsWith("&"))
+    return false;
+  if (/^\d+$/.test(token))
+    return false;
+  return !token.startsWith("/dev/");
+}
+function unquote(token) {
+  const m = /^(['"])(.*)\1$/.exec(token);
+  return m?.[2] ?? token;
+}
+function segments(command) {
+  return command.split(/\|\||&&|[;|\n]/);
+}
+function lastToken(segment) {
+  const tokens = segment.trim().split(/\s+/).map(unquote).filter((t) => t !== "" && !t.startsWith("-"));
+  const last = tokens.at(-1);
+  return last !== void 0 && isRealPath(last) ? last : void 0;
+}
+function writtenPaths(command, cwd) {
+  const found = /* @__PURE__ */ new Set();
+  let dir = cwd;
+  const add = (path) => {
+    if (!isRealPath(path))
+      return;
+    found.add(dir === void 0 ? path : resolve2(dir, path));
+  };
+  for (const segment of segments(command)) {
+    const trimmed = segment.trim();
+    const moved = /^cd\s+(['"]?)([^\s'";|&<>]+)\1\s*$/.exec(trimmed);
+    if (moved !== null && dir !== void 0) {
+      dir = resolve2(dir, unquote(moved[2] ?? ""));
+      continue;
+    }
+    for (const match of trimmed.matchAll(/>>?\s*(['"]?)([^\s'";|&<>]+)\1/g))
+      add(unquote(match[2] ?? ""));
+    for (const match of trimmed.matchAll(/\btee\s+(?:-a\s+)?(['"]?)([^\s'";|&<>]+)\1/g))
+      add(unquote(match[2] ?? ""));
+    if (/^\s*(sed\s+(-[^\s]*\s+)*-i|cp|mv|install)\b/.test(trimmed)) {
+      const path = lastToken(trimmed);
+      if (path !== void 0)
+        add(path);
+    }
+  }
+  return [...found];
+}
+
+// ../../node_modules/.pnpm/@elaraai+east-plugin@1.0.90_typescript@5.9.3/node_modules/@elaraai/east-plugin/dist/lib/transcript.js
+import { readFile } from "node:fs/promises";
+var SEARCH_TOOLS = ["mcp__plugin_east_east__search_east_examples", "mcp__plugin_east_east__get_east_example", "mcp__east__search_east_examples", "mcp__east__get_east_example"];
+async function searchedInTranscript(transcriptPath, tools = SEARCH_TOOLS) {
+  let raw;
+  try {
+    raw = await readFile(transcriptPath, "utf-8");
+  } catch {
+    return false;
+  }
+  return tools.some((tool) => raw.includes(`"name":"${tool}"`) || raw.includes(`"name": "${tool}"`));
+}
+
+// ../../node_modules/.pnpm/@elaraai+east-plugin@1.0.90_typescript@5.9.3/node_modules/@elaraai/east-plugin/dist/lib/search-guidance.js
+var EAST_GUIDANCE = {
+  searchTool: "mcp__plugin_east_east__search_east_examples",
+  getTool: "mcp__plugin_east_east__get_east_example",
+  corpus: "East",
+  scope: "@elaraai"
+};
+function bare(tool) {
+  const at = tool.lastIndexOf("__");
+  return at < 0 ? tool : tool.slice(at + 2);
+}
+function gateText(g) {
+  return [
+    `STOP: no ${g.corpus} example search on record in this session, and this is ${g.corpus} code.`,
+    `Before writing or changing ${g.corpus} code, search the tested example index \u2014 it is the API reference:`,
+    `1. \`${g.searchTool}\` with what you are about to do (language: "python" for east-py, "typescript" otherwise); summaries come back \u2014 id, signature, inputs and result.`,
+    `2. \`${g.getTool}\` for the one or two that match, and pattern your code on them.`,
+    `Do not read node_modules/${g.scope}/** or *.examples.ts files instead: the index is the same corpus, exact and far cheaper. Every ${g.corpus} skill requires this step.`
+  ].join("\n");
+}
+function readText(g) {
+  return [
+    `Note: the ${g.corpus} example index is the API reference \u2014 \`${g.searchTool}\` (then \`${bare(g.getTool)}\`) returns the same tested programs as the ${g.corpus} packages' examples and type declarations, exact, printed in TypeScript or python, at a fraction of the tokens.`,
+    `Reading \`.d.ts\` signatures or sweeping \`*.examples.ts\` files reliably produces broken ${g.corpus} code that still type-checks: the signatures omit the runtime rules. Search instead, and read a specific file only when the search pointed you at it.`
+  ].join("\n");
+}
+function corpusReadFor(scope) {
+  const escaped = scope.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const packagePath = new RegExp(`[/\\\\]node_modules[/\\\\]${escaped}[/\\\\]`);
+  const packagePattern = new RegExp(`(^|[/\\\\])node_modules[/\\\\]${escaped}([/\\\\]|$)`);
+  const examplesFile = /\.examples\.tsx?$/;
+  return (tool, input) => {
+    const file = typeof input["file_path"] === "string" ? input["file_path"] : "";
+    const dir = typeof input["path"] === "string" ? input["path"] : "";
+    const pattern = typeof input["pattern"] === "string" ? input["pattern"] : "";
+    return tool === "Read" ? packagePath.test(file) || examplesFile.test(file) : packagePath.test(dir) || packagePattern.test(pattern) || /\.examples\.tsx?/.test(pattern);
+  };
+}
+var GATE_TEXT = gateText(EAST_GUIDANCE);
+var READ_TEXT = readText(EAST_GUIDANCE);
+var isExampleCorpusRead = corpusReadFor(EAST_GUIDANCE.scope);
+
+// ../../node_modules/.pnpm/@elaraai+east-plugin@1.0.90_typescript@5.9.3/node_modules/@elaraai/east-plugin/dist/lib/codex-hook.js
+function codexToolCall(event) {
+  const cwd = event.cwd || process.cwd();
+  const input = event.tool_input ?? {};
+  const command = typeof input.command === "string" ? input.command : typeof input["cmd"] === "string" ? input["cmd"] : "";
+  const tool = event.tool_name ?? "";
+  const patches = tool === "apply_patch" ? patchFiles(command, cwd) : [];
+  const shell = ["Bash", "exec_command", "shell_command"].includes(tool);
+  const filePath = typeof input.file_path === "string" ? resolve3(cwd, input.file_path) : void 0;
+  const paths = [.../* @__PURE__ */ new Set([
+    ...patches.filter((p) => !p.deleted).map((p) => p.path),
+    ...shell ? [...writtenPaths(command, cwd), ...shellReadPaths(command, cwd)] : [],
+    ...filePath ? [filePath] : []
+  ])];
+  return { tool, command, shell, patches, filePath, paths };
+}
+async function codexSearchGate(event, options, call = codexToolCall(event)) {
+  const input = event.tool_input ?? {};
+  const marker = join(tmpdir(), options.markerPrefix + createHash("sha256").update(event.session_id ?? "").digest("hex"));
+  if (event.hook_event_name === "PostToolUse") {
+    if (call.tool.startsWith("mcp__") && options.searchToolName.test(call.tool)) {
+      if (event.tool_response?.["isError"] !== true)
+        writeFileSync(marker, "searched");
+      return "recorded";
+    }
+    return null;
+  }
+  const context = [];
+  if (options.isCorpusRead(call.tool, input) || call.shell && options.shellSweep.test(call.command)) {
+    context.push(options.readText);
+  }
+  const writes = call.tool === "apply_patch" ? call.patches.filter((p) => !p.deleted) : call.shell ? writtenPaths(call.command, event.cwd || process.cwd()).map((path) => ({ path, originalPath: path, code: call.command })) : call.filePath && ["Edit", "Write"].includes(call.tool) ? [{ path: call.filePath, originalPath: call.filePath, code: input.content ?? input.new_string ?? "" }] : [];
+  let corpusWrite = false;
+  for (const file of writes) {
+    if (!/\.(tsx?|js|py)$/.test(file.path))
+      continue;
+    let old = "";
+    try {
+      old = await readFile2(file.originalPath, "utf8");
+    } catch {
+    }
+    if (options.corpusCode.test(old + "\n" + file.code))
+      corpusWrite = true;
+  }
+  if (corpusWrite && !existsSync(marker) && !(event.transcript_path && await searchedInTranscript(event.transcript_path, options.searchTools))) {
+    if (process.env[options.requireSearchEnv] === "deny")
+      return { decision: "deny", text: options.gateText };
+    context.push(options.gateText);
+  }
+  return context.length > 0 ? { decision: "context", text: context.join("\n\n") } : null;
+}
+
+// ../../node_modules/.pnpm/@elaraai+east-plugin@1.0.90_typescript@5.9.3/node_modules/@elaraai/east-plugin/dist/lib/host.js
+import { existsSync as existsSync2 } from "node:fs";
+import { fileURLToPath } from "node:url";
+var isCodex = existsSync2(fileURLToPath(new URL("../../.codex-plugin/plugin.json", import.meta.url)));
+function hostText(text) {
+  return isCodex ? text.replaceAll("mcp__plugin_east_east__", "").replaceAll("/east:", "$east-codex-plugin:").replaceAll("Claude Code", "Codex") : text;
+}
+
+// ../../node_modules/.pnpm/@elaraai+east-plugin@1.0.90_typescript@5.9.3/node_modules/@elaraai/east-plugin/dist/lib/hook-io.js
+async function readHookInput() {
+  let input = "";
+  for await (const chunk of process.stdin) {
+    input += chunk;
+  }
+  return JSON.parse(input);
+}
+function writeHookOutput(hookEventName, additionalContext) {
+  const output = {
+    hookSpecificOutput: {
+      hookEventName,
+      additionalContext: hostText(additionalContext)
+    }
+  };
+  process.stdout.write(JSON.stringify(output));
+}
+function writeHookDecision(hookEventName, decision, reason) {
+  const output = {
+    hookSpecificOutput: {
+      hookEventName,
+      permissionDecision: decision,
+      permissionDecisionReason: hostText(reason)
+    }
+  };
+  process.stdout.write(JSON.stringify(output));
+}
+
+// ../../node_modules/.pnpm/@elaraai+east-plugin@1.0.90_typescript@5.9.3/node_modules/@elaraai/east-plugin/dist/lib/search-hooks.js
+function writeSearchHookReply(hookEventName, reply) {
+  if (reply.decision === "deny")
+    writeHookDecision(hookEventName, "deny", reply.text);
+  else
+    writeHookOutput(hookEventName, reply.text);
+}
+
+// ../e3-cloud-plugin/dist/lib/names.js
+var E3_CLOUD_PLUGIN = "e3-cloud";
+var E3_CLOUD_SERVER = "e3-cloud";
+var E3_CLOUD_SEARCH_TOOL = "search_e3_cloud_examples";
+var E3_CLOUD_GET_TOOL = "get_e3_cloud_example";
+var E3_CLOUD_CORPUS = "e3 cloud";
+var CLAUDE_TOOL_PREFIX = `mcp__plugin_${E3_CLOUD_PLUGIN}_${E3_CLOUD_SERVER}__`;
+var E3_CLOUD_GUIDANCE = {
+  searchTool: `${CLAUDE_TOOL_PREFIX}${E3_CLOUD_SEARCH_TOOL}`,
+  getTool: `${CLAUDE_TOOL_PREFIX}${E3_CLOUD_GET_TOOL}`,
+  corpus: E3_CLOUD_CORPUS,
+  scope: "@elaraai"
+};
+var E3_CLOUD_CODE = /@elaraai\/e3-cloud-(?:ui|client)\b/;
+var PACKAGE_PATH = /[/\\]node_modules[/\\]@elaraai[/\\]e3-cloud-(?:ui|cli|client)(?:[/\\]|$)/;
+var PACKAGE_PATTERN = /(?:^|[/\\])node_modules[/\\]@elaraai[/\\]e3-cloud-(?:ui|cli|client)(?:[/\\]|$)/;
+function isE3CloudCorpusRead(tool, input) {
+  const text = (key) => typeof input[key] === "string" ? input[key] : "";
+  return tool === "Read" ? PACKAGE_PATH.test(text("file_path")) : PACKAGE_PATH.test(text("path")) || PACKAGE_PATTERN.test(text("pattern"));
+}
+var E3_CLOUD_SEARCH_GATE = {
+  searchTools: [E3_CLOUD_GUIDANCE.searchTool, E3_CLOUD_GUIDANCE.getTool, ...SEARCH_TOOLS],
+  gateText: gateText(E3_CLOUD_GUIDANCE),
+  isCorpusCode: (code, python) => !python && E3_CLOUD_CODE.test(code),
+  markerPrefix: "e3-cloud-search-seen",
+  requireSearchEnv: "E3_CLOUD_REQUIRE_SEARCH"
+};
+var E3_CLOUD_READ_REMINDER = {
+  readText: readText(E3_CLOUD_GUIDANCE),
+  isCorpusRead: isE3CloudCorpusRead
+};
+var E3_CLOUD_CODEX_SEARCH_GATE = {
+  searchTools: E3_CLOUD_SEARCH_GATE.searchTools,
+  searchToolName: /__(?:search_e3_cloud_examples|get_e3_cloud_example|search_east_examples|get_east_example)$/,
+  gateText: E3_CLOUD_SEARCH_GATE.gateText,
+  readText: E3_CLOUD_READ_REMINDER.readText,
+  isCorpusRead: isE3CloudCorpusRead,
+  shellSweep: /node_modules\/@elaraai\/e3-cloud-(?:ui|cli|client)\b/,
+  corpusCode: E3_CLOUD_CODE,
+  markerPrefix: "e3-cloud-codex-search-",
+  requireSearchEnv: "E3_CLOUD_REQUIRE_SEARCH"
+};
+var E3_CLOUD_SKILL_NAMES = {
+  claudeToolPrefix: CLAUDE_TOOL_PREFIX,
+  claudeSkillPrefix: `/${E3_CLOUD_PLUGIN}:`,
+  codexSkillPrefix: "$e3-cloud-codex-plugin:",
+  claudePlugin: "e3-cloud-claude-plugin",
+  codexPlugin: "e3-cloud-codex-plugin"
+};
+
+// ../e3-cloud-plugin/dist/hooks/codex-tools.js
+async function main() {
+  const event = await readHookInput();
+  const gate = await codexSearchGate(event, E3_CLOUD_CODEX_SEARCH_GATE, codexToolCall(event));
+  if (event.hook_event_name === "PreToolUse" && gate !== null && gate !== "recorded")
+    writeSearchHookReply("PreToolUse", gate);
+}
+main().catch((error) => {
+  process.stderr.write(`e3 cloud hook: ${String(error)}
+`);
+});