@openclaw/codex 2026.5.2 → 2026.5.3-beta.2

package/src/app-server/elicitation-bridge.ts

@@ -1,555 +0,0 @@
-import {
-  embeddedAgentLog,
-  type EmbeddedRunAttemptParams,
-} from "openclaw/plugin-sdk/agent-harness-runtime";
-import {
-  approvalRequestExplicitlyUnavailable,
-  mapExecDecisionToOutcome,
-  requestPluginApproval,
-  type AppServerApprovalOutcome,
-  waitForPluginApprovalDecision,
-} from "./plugin-approval-roundtrip.js";
-import { isJsonObject, type JsonObject, type JsonValue } from "./protocol.js";
-
-type ApprovalPropertyContext = {
-  name: string;
-  schema: JsonObject;
-  required: boolean;
-};
-
-type BridgeableApprovalElicitation = {
-  title: string;
-  description: string;
-  requestedSchema: JsonObject;
-  meta: JsonObject;
-};
-
-const MCP_TOOL_APPROVAL_KIND = "mcp_tool_call";
-const MCP_TOOL_APPROVAL_KIND_KEY = "codex_approval_kind";
-const MCP_TOOL_APPROVAL_CONNECTOR_NAME_KEY = "connector_name";
-const MCP_TOOL_APPROVAL_TOOL_TITLE_KEY = "tool_title";
-const MCP_TOOL_APPROVAL_TOOL_DESCRIPTION_KEY = "tool_description";
-const MCP_TOOL_APPROVAL_TOOL_PARAMS_DISPLAY_KEY = "tool_params_display";
-const MAX_DISPLAY_PARAM_ENTRIES = 8;
-const MAX_DISPLAY_PARAM_VALUE_LENGTH = 120;
-const MAX_DISPLAY_VALUE_ARRAY_ITEMS = 8;
-const MAX_DISPLAY_VALUE_OBJECT_KEYS = 8;
-const MAX_DISPLAY_VALUE_DEPTH = 3;
-const DISPLAY_TEXT_SCAN_MAX_LENGTH = 4096;
-const ANSI_OSC_SEQUENCE_RE = new RegExp(
-  String.raw`(?:\u001b]|\u009d)[^\u001b\u009c\u0007]*(?:\u0007|\u001b\\|\u009c)`,
-  "g",
-);
-const ANSI_CONTROL_SEQUENCE_RE = new RegExp(
-  String.raw`(?:\u001b\[[0-?]*[ -/]*[@-~]|\u009b[0-?]*[ -/]*[@-~]|\u001b[@-Z\\-_])`,
-  "g",
-);
-const CONTROL_CHARACTER_RE = new RegExp(String.raw`[\u0000-\u001f\u007f-\u009f]+`, "g");
-const INVISIBLE_FORMATTING_CONTROL_RE = new RegExp(
-  String.raw`[\u00ad\u034f\u061c\u200b-\u200f\u202a-\u202e\u2060-\u206f\ufeff\ufe00-\ufe0f\u{e0100}-\u{e01ef}]`,
-  "gu",
-);
-const DANGLING_TERMINAL_SEQUENCE_SUFFIX_RE = new RegExp(
-  String.raw`(?:\u001b\][^\u001b\u009c\u0007]*|\u009d[^\u001b\u009c\u0007]*|\u001b\[[0-?]*[ -/]*|\u009b[0-?]*[ -/]*|\u001b)$`,
-);
-
-export async function handleCodexAppServerElicitationRequest(params: {
-  requestParams: JsonValue | undefined;
-  paramsForRun: EmbeddedRunAttemptParams;
-  threadId: string;
-  turnId: string;
-  signal?: AbortSignal;
-}): Promise<JsonValue | undefined> {
-  const requestParams = isJsonObject(params.requestParams) ? params.requestParams : undefined;
-  if (!matchesCurrentTurn(requestParams, params.threadId, params.turnId)) {
-    return undefined;
-  }
-  const approvalPrompt = readBridgeableApprovalElicitation(requestParams);
-  if (!approvalPrompt) {
-    return undefined;
-  }
-
-  const outcome = await requestPluginApprovalOutcome({
-    paramsForRun: params.paramsForRun,
-    title: approvalPrompt.title,
-    description: approvalPrompt.description,
-    signal: params.signal,
-  });
-  return buildElicitationResponse(approvalPrompt.requestedSchema, approvalPrompt.meta, outcome);
-}
-
-function matchesCurrentTurn(
-  requestParams: JsonObject | undefined,
-  threadId: string,
-  turnId: string,
-): boolean {
-  if (!requestParams) {
-    return false;
-  }
-  const requestThreadId = readString(requestParams, "threadId");
-  if (requestThreadId !== threadId) {
-    return false;
-  }
-  const rawTurnId = requestParams.turnId;
-  if (rawTurnId !== null && rawTurnId !== undefined && rawTurnId !== turnId) {
-    return false;
-  }
-  return true;
-}
-
-function readBridgeableApprovalElicitation(
-  requestParams: JsonObject | undefined,
-): BridgeableApprovalElicitation | undefined {
-  if (
-    !requestParams ||
-    readString(requestParams, "mode") !== "form" ||
-    !isJsonObject(requestParams._meta) ||
-    requestParams._meta[MCP_TOOL_APPROVAL_KIND_KEY] !== MCP_TOOL_APPROVAL_KIND ||
-    !isJsonObject(requestParams.requestedSchema)
-  ) {
-    return undefined;
-  }
-
-  const requestedSchema = requestParams.requestedSchema;
-  if (
-    readString(requestedSchema, "type") !== "object" ||
-    !isJsonObject(requestedSchema.properties)
-  ) {
-    return undefined;
-  }
-
-  const title =
-    sanitizeDisplayText(readString(requestParams, "message") ?? "") || "Codex MCP tool approval";
-  return {
-    title,
-    description: buildApprovalDescription({
-      title,
-      meta: requestParams._meta,
-      requestedSchema,
-      serverName: sanitizeOptionalDisplayText(readString(requestParams, "serverName")),
-    }),
-    requestedSchema,
-    meta: requestParams._meta,
-  };
-}
-
-function buildApprovalDescription(params: {
-  title: string;
-  meta: JsonObject;
-  requestedSchema: JsonObject;
-  serverName: string | undefined;
-}): string {
-  const connectorName = sanitizeOptionalDisplayText(
-    readString(params.meta, MCP_TOOL_APPROVAL_CONNECTOR_NAME_KEY),
-  );
-  const toolTitle = sanitizeOptionalDisplayText(
-    readString(params.meta, MCP_TOOL_APPROVAL_TOOL_TITLE_KEY),
-  );
-  const toolDescription = sanitizeOptionalDisplayText(
-    readString(params.meta, MCP_TOOL_APPROVAL_TOOL_DESCRIPTION_KEY),
-  );
-  const summaryLines = [
-    connectorName && `App: ${connectorName}`,
-    toolTitle && `Tool: ${toolTitle}`,
-    params.serverName && `MCP server: ${params.serverName}`,
-    toolDescription,
-  ].filter((line): line is string => Boolean(line));
-  const paramLines = readDisplayParamLines(params.meta);
-  const propertyLines = readPropertyDescriptionLines(params.requestedSchema);
-  return [
-    params.title,
-    summaryLines.join("\n"),
-    paramLines.length > 0 ? ["Parameters:", ...paramLines].join("\n") : "",
-    propertyLines.length > 0 ? ["Fields:", ...propertyLines].join("\n") : "",
-  ]
-    .filter(Boolean)
-    .join("\n\n");
-}
-
-function readPropertyDescriptionLines(requestedSchema: JsonObject): string[] {
-  const properties = isJsonObject(requestedSchema.properties) ? requestedSchema.properties : {};
-  return Object.entries(properties)
-    .map(([name, value]) => {
-      const schema = isJsonObject(value) ? value : undefined;
-      if (!schema) {
-        return undefined;
-      }
-      const propTitle =
-        sanitizeDisplayText(readString(schema, "title") ?? "") ||
-        sanitizeDisplayText(name) ||
-        "field";
-      const description = sanitizeOptionalDisplayText(readString(schema, "description"));
-      return description ? `- ${propTitle}: ${description}` : `- ${propTitle}`;
-    })
-    .filter((line): line is string => Boolean(line));
-}
-
-function readDisplayParamLines(meta: JsonObject): string[] {
-  const displayParams = meta[MCP_TOOL_APPROVAL_TOOL_PARAMS_DISPLAY_KEY];
-  if (!Array.isArray(displayParams)) {
-    return [];
-  }
-  const lines = displayParams
-    .slice(0, MAX_DISPLAY_PARAM_ENTRIES)
-    .map((entry) => {
-      const param = isJsonObject(entry) ? entry : undefined;
-      if (!param) {
-        return undefined;
-      }
-      const name =
-        sanitizeOptionalDisplayText(readString(param, "display_name")) ??
-        sanitizeOptionalDisplayText(readString(param, "name"));
-      if (!name) {
-        return undefined;
-      }
-      return `- ${name}: ${formatDisplayParamValue(param.value)}`;
-    })
-    .filter((line): line is string => Boolean(line));
-  const remaining = displayParams.length - MAX_DISPLAY_PARAM_ENTRIES;
-  return remaining > 0 ? [...lines, `- Additional parameters: ${remaining} more`] : lines;
-}
-
-function formatDisplayParamValue(value: JsonValue | undefined): string {
-  const formatted = typeof value === "string" ? value : formatDisplayJsonValue(value ?? null);
-  return truncateDisplayText(sanitizeDisplayText(formatted), MAX_DISPLAY_PARAM_VALUE_LENGTH);
-}
-
-function formatDisplayJsonValue(value: JsonValue, depth = MAX_DISPLAY_VALUE_DEPTH): string {
-  if (value === null) {
-    return "null";
-  }
-  if (typeof value === "string") {
-    return JSON.stringify(truncateDisplayText(sanitizeDisplayText(value), 80));
-  }
-  if (typeof value === "number" || typeof value === "boolean") {
-    return String(value);
-  }
-  if (Array.isArray(value)) {
-    if (depth <= 0) {
-      return "[truncated]";
-    }
-    const parts: string[] = [];
-    const limit = Math.min(value.length, MAX_DISPLAY_VALUE_ARRAY_ITEMS);
-    for (let i = 0; i < limit; i += 1) {
-      parts.push(formatDisplayJsonValue(value[i] ?? null, depth - 1));
-    }
-    if (value.length > MAX_DISPLAY_VALUE_ARRAY_ITEMS) {
-      parts.push("...");
-    }
-    return `[${parts.join(",")}]`;
-  }
-  if (typeof value === "object") {
-    if (depth <= 0) {
-      return "{truncated}";
-    }
-    const parts: string[] = [];
-    let count = 0;
-    let truncated = false;
-    for (const key in value) {
-      if (!Object.prototype.hasOwnProperty.call(value, key)) {
-        continue;
-      }
-      if (count >= MAX_DISPLAY_VALUE_OBJECT_KEYS) {
-        truncated = true;
-        break;
-      }
-      const safeKey = truncateDisplayText(sanitizeDisplayText(key), 80);
-      parts.push(
-        `${JSON.stringify(safeKey)}:${formatDisplayJsonValue(value[key] ?? null, depth - 1)}`,
-      );
-      count += 1;
-    }
-    if (truncated) {
-      parts.push("...");
-    }
-    return `{${parts.join(",")}}`;
-  }
-  return "null";
-}
-
-function sanitizeOptionalDisplayText(value: string | undefined): string | undefined {
-  const sanitized = value === undefined ? "" : sanitizeDisplayText(value);
-  return sanitized || undefined;
-}
-
-function sanitizeDisplayText(value: string): string {
-  const scanned = value.slice(0, DISPLAY_TEXT_SCAN_MAX_LENGTH);
-  const clipped = value.length > DISPLAY_TEXT_SCAN_MAX_LENGTH;
-  const sanitized = scanned
-    .replace(ANSI_OSC_SEQUENCE_RE, "")
-    .replace(ANSI_CONTROL_SEQUENCE_RE, "")
-    .replace(DANGLING_TERMINAL_SEQUENCE_SUFFIX_RE, "")
-    .replace(INVISIBLE_FORMATTING_CONTROL_RE, " ")
-    .replace(CONTROL_CHARACTER_RE, " ")
-    .replace(/\s+/g, " ")
-    .trim();
-  return clipped ? `${sanitized}...` : sanitized;
-}
-
-function truncateDisplayText(value: string, maxLength: number): string {
-  return value.length <= maxLength ? value : `${value.slice(0, Math.max(0, maxLength - 3))}...`;
-}
-
-async function requestPluginApprovalOutcome(params: {
-  paramsForRun: EmbeddedRunAttemptParams;
-  title: string;
-  description: string;
-  signal?: AbortSignal;
-}): Promise<AppServerApprovalOutcome> {
-  try {
-    const requestResult = await requestPluginApproval({
-      paramsForRun: params.paramsForRun,
-      title: params.title,
-      description: params.description,
-      severity: "warning",
-      toolName: "codex_mcp_tool_approval",
-    });
-
-    const approvalId = requestResult?.id;
-    if (!approvalId) {
-      return "unavailable";
-    }
-
-    const decision = approvalRequestExplicitlyUnavailable(requestResult)
-      ? null
-      : await waitForPluginApprovalDecision({ approvalId, signal: params.signal });
-    return mapExecDecisionToOutcome(decision);
-  } catch {
-    return params.signal?.aborted ? "cancelled" : "denied";
-  }
-}
-
-function buildElicitationResponse(
-  requestedSchema: JsonObject,
-  meta: JsonObject,
-  outcome: AppServerApprovalOutcome,
-): JsonValue {
-  if (outcome === "cancelled") {
-    return { action: "cancel", content: null, _meta: null };
-  }
-  if (outcome === "denied" || outcome === "unavailable") {
-    return { action: "decline", content: null, _meta: null };
-  }
-
-  const content = buildAcceptedContent(requestedSchema, meta, outcome);
-  if (!content) {
-    if (hasNoSchemaProperties(requestedSchema)) {
-      return {
-        action: "accept",
-        content: null,
-        _meta: buildAcceptedMeta(meta, outcome),
-      };
-    }
-    embeddedAgentLog.warn("codex MCP approval elicitation approved without a mappable response", {
-      approvalKind: meta[MCP_TOOL_APPROVAL_KIND_KEY],
-      fields: Object.keys(requestedSchema.properties ?? {}),
-      outcome,
-    });
-    return { action: "decline", content: null, _meta: null };
-  }
-  return { action: "accept", content, _meta: buildAcceptedMeta(meta, outcome) };
-}
-
-function buildAcceptedContent(
-  requestedSchema: JsonObject,
-  meta: JsonObject,
-  outcome: AppServerApprovalOutcome,
-): JsonObject | undefined {
-  const properties = isJsonObject(requestedSchema.properties)
-    ? requestedSchema.properties
-    : undefined;
-  if (!properties) {
-    return undefined;
-  }
-  const required = Array.isArray(requestedSchema.required)
-    ? new Set(
-        requestedSchema.required.filter((entry): entry is string => typeof entry === "string"),
-      )
-    : new Set<string>();
-  const content: JsonObject = {};
-  let sawApprovalField = false;
-
-  for (const [name, value] of Object.entries(properties)) {
-    const schema = isJsonObject(value) ? value : undefined;
-    if (!schema) {
-      continue;
-    }
-    const property = { name, schema, required: required.has(name) };
-    const next =
-      readApprovalFieldValue(property, outcome) ??
-      readPersistFieldValue(property, meta, outcome) ??
-      readFallbackFieldValue(property, outcome);
-
-    if (next === undefined) {
-      if (isApprovalField(property)) {
-        sawApprovalField = true;
-      }
-      if (property.required) {
-        return undefined;
-      }
-      continue;
-    }
-
-    if (isApprovalField(property)) {
-      sawApprovalField = true;
-    }
-    content[name] = next;
-  }
-
-  return sawApprovalField ? content : undefined;
-}
-
-function readApprovalFieldValue(
-  property: ApprovalPropertyContext,
-  outcome: AppServerApprovalOutcome,
-): JsonValue | undefined {
-  if (!isApprovalField(property)) {
-    return undefined;
-  }
-  const type = readString(property.schema, "type");
-  if (type === "boolean") {
-    return true;
-  }
-  const options = readEnumOptions(property.schema);
-  if (options.length === 0) {
-    return undefined;
-  }
-
-  const sessionChoice = options.find((option) => isSessionApprovalOption(option));
-  const acceptChoice = options.find((option) => isPositiveApprovalOption(option));
-  if (outcome === "approved-session") {
-    return sessionChoice?.value ?? acceptChoice?.value;
-  }
-  return acceptChoice?.value ?? sessionChoice?.value;
-}
-
-function readPersistFieldValue(
-  property: ApprovalPropertyContext,
-  meta: JsonObject,
-  outcome: AppServerApprovalOutcome,
-): JsonValue | undefined {
-  if (!isPersistField(property) || outcome !== "approved-session") {
-    return undefined;
-  }
-  const persistHints = readPersistHints(meta);
-  const options = readEnumOptions(property.schema);
-  if (options.length === 0) {
-    return undefined;
-  }
-  const preferred = choosePersistHint(persistHints);
-  if (preferred) {
-    const match = options.find(
-      (option) => option.value === preferred || option.label === preferred,
-    );
-    return match?.value;
-  }
-  return undefined;
-}
-
-function readDefaultValue(schema: JsonObject): JsonValue | undefined {
-  return schema.default as JsonValue | undefined;
-}
-
-function readFallbackFieldValue(
-  property: ApprovalPropertyContext,
-  outcome: AppServerApprovalOutcome,
-): JsonValue | undefined {
-  if (outcome === "approved-once" && isPersistField(property)) {
-    return undefined;
-  }
-  return readDefaultValue(property.schema);
-}
-
-function isApprovalField(property: ApprovalPropertyContext): boolean {
-  const haystack = propertyText(property).toLowerCase();
-  return /\b(approve|approval|allow|accept|decision)\b/.test(haystack);
-}
-
-function isPersistField(property: ApprovalPropertyContext): boolean {
-  const haystack = propertyText(property).toLowerCase();
-  return /\b(persist|session|always|scope)\b/.test(haystack);
-}
-
-function propertyText(property: ApprovalPropertyContext): string {
-  return [
-    property.name,
-    readString(property.schema, "title"),
-    readString(property.schema, "description"),
-  ]
-    .filter(Boolean)
-    .join(" ");
-}
-
-function readPersistHints(meta: JsonObject): string[] {
-  const raw = meta.persist;
-  if (typeof raw === "string") {
-    return [raw];
-  }
-  if (Array.isArray(raw)) {
-    return raw.filter((entry): entry is string => typeof entry === "string");
-  }
-  return ["session", "always"];
-}
-
-function buildAcceptedMeta(meta: JsonObject, outcome: AppServerApprovalOutcome): JsonObject | null {
-  if (outcome !== "approved-session") {
-    return null;
-  }
-  const persist = choosePersistHint(readPersistHints(meta));
-  return persist ? { persist } : null;
-}
-
-function choosePersistHint(persistHints: string[]): "always" | "session" | undefined {
-  if (persistHints.includes("always")) {
-    return "always";
-  }
-  if (persistHints.includes("session")) {
-    return "session";
-  }
-  return undefined;
-}
-
-function hasNoSchemaProperties(requestedSchema: JsonObject): boolean {
-  const properties = isJsonObject(requestedSchema.properties) ? requestedSchema.properties : {};
-  return Object.keys(properties).length === 0;
-}
-
-function readEnumOptions(schema: JsonObject): Array<{ value: string; label: string }> {
-  if (Array.isArray(schema.enum)) {
-    const values = schema.enum.filter((entry): entry is string => typeof entry === "string");
-    const labels = Array.isArray(schema.enumNames)
-      ? schema.enumNames.filter((entry): entry is string => typeof entry === "string")
-      : [];
-    return values.map((value, index) => ({ value, label: labels[index] ?? value }));
-  }
-  if (Array.isArray(schema.oneOf)) {
-    return schema.oneOf
-      .map((entry) => {
-        const option = isJsonObject(entry) ? entry : undefined;
-        const value = readString(option, "const");
-        if (!value) {
-          return undefined;
-        }
-        return { value, label: readString(option, "title") ?? value };
-      })
-      .filter((entry): entry is { value: string; label: string } => Boolean(entry));
-  }
-  return [];
-}
-
-function isPositiveApprovalOption(option: { value: string; label: string }): boolean {
-  const haystack = `${option.value} ${option.label}`.toLowerCase();
-  return /\b(allow|approve|accept|yes|continue|proceed|true)\b/.test(haystack);
-}
-
-function isSessionApprovalOption(option: { value: string; label: string }): boolean {
-  const haystack = `${option.value} ${option.label}`.toLowerCase();
-  return (
-    /\b(session|always|persistent)\b/.test(haystack) && /\b(allow|approve|accept)\b/.test(haystack)
-  );
-}
-
-function readString(record: JsonObject | undefined, key: string): string | undefined {
-  const value = record?.[key];
-  return typeof value === "string" && value.trim() ? value : undefined;
-}