@opengeni/contracts 3.1.0-canary.1 → 3.1.2

package/dist/chunk-TCXCRBPF.js

@@ -0,0 +1,267 @@
+// src/tool-review-presentation.ts
+var protectedName = /password|passwd|secret|credential|authorization|cookie|(^|[_-])token($|[_-])|api[_-]?key|accessToken|refreshToken|privateKey/i;
+var protectedReviewField = (key, fields = []) => protectedName.test(key) || fields.includes(key) || fields.includes("*");
+var bound = (value, limit) => value.length > limit ? `${value.slice(0, limit)}\u2026` : value;
+function toolReviewFieldLabel(key) {
+  const label = key.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_-]+/g, " ").replace(/\bids?\b/gi, (word) => word.length === 3 ? "IDs" : "ID").replace(
+    /\b(api|url|uri|http|https|ip|sql|json|html)(s?)\b/gi,
+    (_word, name, plural) => `${name.toUpperCase()}${plural}`
+  ).replace(
+    /(?<=\S\s+)([A-Z])([a-z]+)\b/g,
+    (_word, first, rest) => `${first.toLowerCase()}${rest}`
+  ).trim();
+  return label.charAt(0).toUpperCase() + label.slice(1);
+}
+function decodeReviewArguments(value) {
+  let decoded = value;
+  if (typeof decoded === "string") {
+    try {
+      decoded = JSON.parse(decoded);
+    } catch {
+      return null;
+    }
+  }
+  return decoded && typeof decoded === "object" && !Array.isArray(decoded) ? decoded : null;
+}
+function safeReviewValue(value, key = "", protectedFields = [], depth = 0) {
+  if (protectedReviewField(key, protectedFields)) return "[Protected value]";
+  if (depth > 20) return "[Nested value; open this field for details]";
+  if (Array.isArray(value))
+    return value.map((entry) => safeReviewValue(entry, "", protectedFields, depth + 1));
+  if (value && typeof value === "object")
+    return Object.fromEntries(
+      Object.entries(value).map(([name, entry]) => [
+        name,
+        safeReviewValue(entry, name, protectedFields, depth + 1)
+      ])
+    );
+  return value;
+}
+function valueText(value) {
+  return typeof value === "string" ? value : value === null ? "None" : typeof value === "boolean" ? value ? "Yes" : "No" : JSON.stringify(value) ?? "Unavailable";
+}
+var pointer = (name) => `/${name.replaceAll("~", "~0").replaceAll("/", "~1")}`;
+var fieldPointer = (key, index, parent = "") => pointer(key).length > 256 || parent.length + pointer(key).length > 1024 ? `/~2${index}` : pointer(key);
+function toolReviewFields(argumentsValue, context) {
+  const args = decodeReviewArguments(argumentsValue);
+  if (!args) return { fields: [], moreFields: 0 };
+  const entries = Object.entries(args);
+  if (context?.email) {
+    const email = toolReviewFields(context.email);
+    const original = toolReviewFields(args, { ...context, email: void 0 });
+    const fields = [
+      ...email.fields.filter(
+        (field) => field.path !== "/contentSha256" && field.path !== "/htmlBody" && field.preview !== ""
+      ).map((field) => ({
+        ...field,
+        label: field.path === "/textBody" ? "Message" : field.label,
+        path: `/$email${field.path}`,
+        ...field.path === "/attachments" ? {
+          preview: context.email.attachments.map((attachment) => attachment.name).join(", ").slice(0, 240)
+        } : {}
+      })),
+      ...original.fields.filter(
+        (field) => ![
+          "/raw",
+          "/expectedContentSha256",
+          "/from",
+          "/to",
+          "/cc",
+          "/bcc",
+          "/subject",
+          "/body",
+          "/textBody",
+          "/htmlBody",
+          "/attachments"
+        ].includes(field.path)
+      )
+    ];
+    return {
+      fields: fields.slice(0, 16),
+      moreFields: original.moreFields + Math.max(0, fields.length - 16)
+    };
+  }
+  return {
+    moreFields: Math.max(0, entries.length - 16),
+    fields: entries.slice(0, 16).map(([key, value], index) => {
+      const hidden = protectedReviewField(key, context?.protectedFields);
+      const safe = hidden ? "[Protected value]" : value;
+      const count = !hidden && Array.isArray(value) ? value.length : void 0;
+      const compactList = !hidden && Array.isArray(value) && value.length > 0 && value.length <= 4 && value.every(
+        (entry) => typeof entry === "string" || typeof entry === "number" || typeof entry === "boolean"
+      ) ? value.map(valueText).join(", ") : void 0;
+      const text = compactList !== void 0 ? compactList : count !== void 0 ? `${count.toLocaleString("en-US")} item${count === 1 ? "" : "s"}` : safe && typeof safe === "object" ? `${Object.keys(safe).length} field${Object.keys(safe).length === 1 ? "" : "s"}` : valueText(safe);
+      return {
+        path: fieldPointer(key, index),
+        label: bound(
+          (context?.fieldLabels && Object.hasOwn(context.fieldLabels, key) ? context.fieldLabels[key] : void 0) ?? toolReviewFieldLabel(key),
+          256
+        ),
+        preview: bound(text, 240),
+        ...count !== void 0 ? { count } : {},
+        truncated: !hidden && (text.length > 240 || compactList === void 0 && typeof value === "object" && value !== null),
+        ...hidden ? { protected: true } : {}
+      };
+    })
+  };
+}
+function toolReviewAction(toolName, argumentsValue, context) {
+  const fallback = {
+    title: context?.title ?? bound(
+      toolReviewFieldLabel(
+        toolName.replace(/^mcp_[^_]+__/, "").replace(/^batch[_-](?=[a-z])/i, "")
+      ),
+      256
+    ),
+    approveLabel: "Approve action",
+    effects: []
+  };
+  if (context?.kind !== "gmail") return fallback;
+  const args = decodeReviewArguments(argumentsValue);
+  if (!args) return fallback;
+  const thread = toolName.endsWith("_thread");
+  const selectionKind = thread ? "threads" : "messages";
+  const ids = thread && typeof args.threadId === "string" ? [args.threadId] : Array.isArray(args.messageIds) ? args.messageIds : typeof args.messageId === "string" ? [args.messageId] : null;
+  const selectionCount = ids?.every((id) => typeof id === "string") ? new Set(ids).size : void 0;
+  const noun = selectionCount === void 0 ? thread ? "conversations" : "messages" : `${selectionCount.toLocaleString("en-US")} ${thread ? "conversation" : "message"}${selectionCount === 1 ? "" : "s"}`;
+  const addValues = toolName.startsWith("label_") ? args.labelIds : args.addLabelIds;
+  const adds = Array.isArray(addValues) ? addValues.filter((v) => typeof v === "string") : [];
+  const removeValues = toolName.startsWith("unlabel_") ? args.labelIds : args.removeLabelIds;
+  const removes = Array.isArray(removeValues) ? removeValues.filter((v) => typeof v === "string") : [];
+  const labelEffect = (label, adding) => {
+    const known = {
+      TRASH: ["Move to Trash", "Remove from Trash"],
+      INBOX: ["Move to Inbox", "Remove from Inbox"],
+      UNREAD: ["Mark as unread", "Mark as read"],
+      STARRED: ["Add star", "Remove star"],
+      SPAM: ["Mark as spam", "Remove from Spam"],
+      IMPORTANT: ["Mark as important", "Remove importance"]
+    };
+    return (Object.hasOwn(known, label) ? known[label]?.[adding ? 0 : 1] : void 0) ?? `${adding ? "Add" : "Remove"} label ${bound(label, 120)}`;
+  };
+  const effects = [
+    ...adds.map((id) => labelEffect(id, true)),
+    ...removes.map((id) => labelEffect(id, false))
+  ];
+  if ([
+    "batch_modify_messages",
+    "modify_message",
+    "modify_thread",
+    "label_message",
+    "label_thread",
+    "unlabel_message",
+    "unlabel_thread"
+  ].includes(toolName)) {
+    const trash = adds.includes("TRASH");
+    return {
+      title: trash ? `Move ${noun} to Trash` : `Update ${noun}`,
+      approveLabel: trash ? "Move to Trash" : "Apply changes",
+      effects,
+      ...selectionCount === void 0 ? {} : { selectionCount, selectionKind },
+      ...trash ? { consequence: "Messages stay recoverable in Trash until Gmail deletes them." } : thread ? { consequence: "Applies to every message in the conversation." } : {}
+    };
+  }
+  if (["trash_message", "restore_message", "trash_thread", "restore_thread"].includes(toolName))
+    return {
+      title: toolName.startsWith("trash_") ? `Move ${noun} to Trash` : `Remove ${noun} from Trash`,
+      approveLabel: toolName.startsWith("trash_") ? "Move to Trash" : "Remove from Trash",
+      effects,
+      ...selectionCount === void 0 ? {} : { selectionCount, selectionKind }
+    };
+  const named = {
+    send_message: ["Send email", "Send email"],
+    send_draft: ["Send draft", "Send draft"],
+    create_draft: ["Create email draft", "Create draft"],
+    update_draft: ["Update email draft", "Update draft"],
+    delete_draft: ["Delete email draft", "Delete draft"],
+    create_label: ["Create label", "Create label"],
+    update_label: ["Update label", "Update label"],
+    delete_label: ["Delete label", "Delete label"]
+  };
+  const action = Object.hasOwn(named, toolName) ? named[toolName] : void 0;
+  return action ? { title: action[0], approveLabel: action[1], effects } : fallback;
+}
+function toolReviewDetails(argumentsValue, context, path, offset, limit = 25) {
+  if (!Number.isSafeInteger(offset) || offset < 0 || !Number.isSafeInteger(limit) || limit < 1 || limit > 50)
+    throw new Error("Invalid review page");
+  const args = decodeReviewArguments(argumentsValue);
+  let value = context?.email ? { ...args, $email: context.email } : args;
+  if (path !== "") {
+    if (!path.startsWith("/")) throw new Error("Invalid review field");
+    for (const escaped of path.slice(1).split("/")) {
+      if (/^~2\d+$/.test(escaped)) {
+        if (!value || typeof value !== "object" || Array.isArray(value))
+          throw new Error("Review field not found");
+        const selected = Object.entries(value)[Number(escaped.slice(2))];
+        if (!selected) throw new Error("Review field not found");
+        value = {
+          fieldName: selected[0],
+          value: protectedReviewField(selected[0], context?.protectedFields) ? "[Protected value]" : selected[1]
+        };
+        continue;
+      }
+      const key = escaped.replaceAll("~1", "/").replaceAll("~0", "~");
+      if (protectedReviewField(key, context?.protectedFields)) {
+        value = "[Protected value]";
+        break;
+      }
+      if (!value || typeof value !== "object" || !Object.hasOwn(value, key))
+        throw new Error("Review field not found");
+      value = value[key];
+    }
+  }
+  const preview = (entry, key, childPath) => {
+    const hidden = protectedReviewField(key, context?.protectedFields);
+    if (!hidden && entry !== null && typeof entry === "object") {
+      const count = Array.isArray(entry) ? entry.length : Object.keys(entry).length;
+      return {
+        value: `${count.toLocaleString("en-US")} ${Array.isArray(entry) ? count === 1 ? "item" : "items" : count === 1 ? "field" : "fields"}`,
+        path: childPath,
+        truncated: true
+      };
+    }
+    const text = valueText(safeReviewValue(entry, key, context?.protectedFields));
+    return {
+      value: bound(text, 4e3),
+      ...hidden ? {} : { path: childPath },
+      truncated: !hidden && text.length > 4e3
+    };
+  };
+  let total;
+  let items;
+  if (Array.isArray(value)) {
+    total = value.length;
+    items = value.slice(offset, offset + limit).map((entry, index) => ({
+      label: `${offset + index + 1}`,
+      ...preview(entry, "", `${path}/${offset + index}`)
+    }));
+  } else if (value && typeof value === "object") {
+    const entries = Object.entries(value);
+    total = entries.length;
+    items = entries.slice(offset, offset + limit).map(([key, entry], index) => ({
+      label: bound(
+        (context?.fieldLabels && Object.hasOwn(context.fieldLabels, key) ? context.fieldLabels[key] : void 0) ?? toolReviewFieldLabel(key),
+        256
+      ),
+      ...preview(entry, key, `${path}${fieldPointer(key, offset + index, path)}`)
+    }));
+  } else {
+    const text = valueText(value);
+    total = Math.max(1, Math.ceil(text.length / 4e3));
+    items = Array.from({ length: Math.max(0, Math.min(limit, total - offset)) }, (_, index) => ({
+      label: `Part ${offset + index + 1}`,
+      value: text.slice((offset + index) * 4e3, (offset + index + 1) * 4e3)
+    }));
+  }
+  return { path, items, total, nextOffset: offset + limit < total ? offset + limit : null };
+}
+
+export {
+  toolReviewFieldLabel,
+  decodeReviewArguments,
+  safeReviewValue,
+  toolReviewFields,
+  toolReviewAction,
+  toolReviewDetails
+};
+//# sourceMappingURL=chunk-TCXCRBPF.js.map

package/dist/chunk-TCXCRBPF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tool-review-presentation.ts"],"sourcesContent":["import type {\n  ToolActionReview,\n  ToolReviewContext,\n  ToolReviewDetailsPage,\n} from \"./tool-action-review\";\n\nconst protectedName =\n  /password|passwd|secret|credential|authorization|cookie|(^|[_-])token($|[_-])|api[_-]?key|accessToken|refreshToken|privateKey/i;\nconst protectedReviewField = (key: string, fields: readonly string[] = []) =>\n  protectedName.test(key) || fields.includes(key) || fields.includes(\"*\");\nconst bound = (value: string, limit: number) =>\n  value.length > limit ? `${value.slice(0, limit)}…` : value;\nexport function toolReviewFieldLabel(key: string): string {\n  const label = key\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .replace(/[_-]+/g, \" \")\n    .replace(/\\bids?\\b/gi, (word) => (word.length === 3 ? \"IDs\" : \"ID\"))\n    .replace(\n      /\\b(api|url|uri|http|https|ip|sql|json|html)(s?)\\b/gi,\n      (_word, name: string, plural: string) => `${name.toUpperCase()}${plural}`,\n    )\n    // Sentence case, keeping acronyms: \"Working Directory\" → \"Working directory\".\n    .replace(\n      /(?<=\\S\\s+)([A-Z])([a-z]+)\\b/g,\n      (_word, first: string, rest: string) => `${first.toLowerCase()}${rest}`,\n    )\n    .trim();\n  return label.charAt(0).toUpperCase() + label.slice(1);\n}\nexport function decodeReviewArguments(value: unknown): Record<string, unknown> | null {\n  // Historical SDK entries sometimes wrapped arguments in JSON. Decode only once.\n  let decoded = value;\n  if (typeof decoded === \"string\") {\n    try {\n      decoded = JSON.parse(decoded);\n    } catch {\n      return null;\n    }\n  }\n  return decoded && typeof decoded === \"object\" && !Array.isArray(decoded)\n    ? (decoded as Record<string, unknown>)\n    : null;\n}\nexport function safeReviewValue(\n  value: unknown,\n  key = \"\",\n  protectedFields: readonly string[] = [],\n  depth = 0,\n): unknown {\n  if (protectedReviewField(key, protectedFields)) return \"[Protected value]\";\n  if (depth > 20) return \"[Nested value; open this field for details]\";\n  if (Array.isArray(value))\n    return value.map((entry) => safeReviewValue(entry, \"\", protectedFields, depth + 1));\n  if (value && typeof value === \"object\")\n    return Object.fromEntries(\n      Object.entries(value).map(([name, entry]) => [\n        name,\n        safeReviewValue(entry, name, protectedFields, depth + 1),\n      ]),\n    );\n  return value;\n}\nfunction valueText(value: unknown): string {\n  return typeof value === \"string\"\n    ? value\n    : value === null\n      ? \"None\"\n      : typeof value === \"boolean\"\n        ? value\n          ? \"Yes\"\n          : \"No\"\n        : (JSON.stringify(value) ?? \"Unavailable\");\n}\nconst pointer = (name: string) => `/${name.replaceAll(\"~\", \"~0\").replaceAll(\"/\", \"~1\")}`;\n// Long arbitrary property names remain readable without placing them in every\n// preview or URL. An indexed segment opens their saved name and value together.\nconst fieldPointer = (key: string, index: number, parent = \"\") =>\n  pointer(key).length > 256 || parent.length + pointer(key).length > 1024\n    ? `/~2${index}`\n    : pointer(key);\n\nexport function toolReviewFields(\n  argumentsValue: unknown,\n  context?: ToolReviewContext,\n): { fields: ToolActionReview[\"fields\"]; moreFields: number } {\n  const args = decodeReviewArguments(argumentsValue);\n  if (!args) return { fields: [], moreFields: 0 };\n  const entries = Object.entries(args);\n  if (context?.email) {\n    const email = toolReviewFields(context.email);\n    const original = toolReviewFields(args, { ...context, email: undefined });\n    const fields = [\n      ...email.fields\n        .filter(\n          (field) =>\n            field.path !== \"/contentSha256\" && field.path !== \"/htmlBody\" && field.preview !== \"\",\n        )\n        .map((field) => ({\n          ...field,\n          label: field.path === \"/textBody\" ? \"Message\" : field.label,\n          path: `/$email${field.path}`,\n          ...(field.path === \"/attachments\"\n            ? {\n                preview: context\n                  .email!.attachments.map((attachment) => attachment.name)\n                  .join(\", \")\n                  .slice(0, 240),\n              }\n            : {}),\n        })),\n      ...original.fields.filter(\n        (field) =>\n          ![\n            \"/raw\",\n            \"/expectedContentSha256\",\n            \"/from\",\n            \"/to\",\n            \"/cc\",\n            \"/bcc\",\n            \"/subject\",\n            \"/body\",\n            \"/textBody\",\n            \"/htmlBody\",\n            \"/attachments\",\n          ].includes(field.path),\n      ),\n    ];\n    return {\n      fields: fields.slice(0, 16),\n      moreFields: original.moreFields + Math.max(0, fields.length - 16),\n    };\n  }\n  return {\n    moreFields: Math.max(0, entries.length - 16),\n    fields: entries.slice(0, 16).map(([key, value], index) => {\n      const hidden = protectedReviewField(key, context?.protectedFields);\n      const safe = hidden ? \"[Protected value]\" : value;\n      const count = !hidden && Array.isArray(value) ? value.length : undefined;\n      const compactList =\n        !hidden &&\n        Array.isArray(value) &&\n        value.length > 0 &&\n        value.length <= 4 &&\n        value.every(\n          (entry) =>\n            typeof entry === \"string\" || typeof entry === \"number\" || typeof entry === \"boolean\",\n        )\n          ? value.map(valueText).join(\", \")\n          : undefined;\n      const text =\n        compactList !== undefined\n          ? compactList\n          : count !== undefined\n            ? `${count.toLocaleString(\"en-US\")} item${count === 1 ? \"\" : \"s\"}`\n            : safe && typeof safe === \"object\"\n              ? `${Object.keys(safe).length} field${Object.keys(safe).length === 1 ? \"\" : \"s\"}`\n              : valueText(safe);\n      return {\n        path: fieldPointer(key, index),\n        label: bound(\n          (context?.fieldLabels && Object.hasOwn(context.fieldLabels, key)\n            ? context.fieldLabels[key]\n            : undefined) ?? toolReviewFieldLabel(key),\n          256,\n        ),\n        preview: bound(text, 240),\n        ...(count !== undefined ? { count } : {}),\n        truncated:\n          !hidden &&\n          (text.length > 240 ||\n            (compactList === undefined && typeof value === \"object\" && value !== null)),\n        ...(hidden ? { protected: true } : {}),\n      };\n    }),\n  };\n}\n\n/** Deterministic consequences from the reviewed bytes. Unknown fields remain visible. */\nexport function toolReviewAction(\n  toolName: string,\n  argumentsValue: unknown,\n  context?: ToolReviewContext,\n): Pick<\n  ToolActionReview,\n  \"title\" | \"approveLabel\" | \"effects\" | \"consequence\" | \"selectionCount\" | \"selectionKind\"\n> {\n  const fallback = {\n    title:\n      context?.title ??\n      bound(\n        toolReviewFieldLabel(\n          toolName.replace(/^mcp_[^_]+__/, \"\").replace(/^batch[_-](?=[a-z])/i, \"\"),\n        ),\n        256,\n      ),\n    approveLabel: \"Approve action\",\n    effects: [] as string[],\n  };\n  if (context?.kind !== \"gmail\") return fallback;\n  const args = decodeReviewArguments(argumentsValue);\n  if (!args) return fallback;\n  const thread = toolName.endsWith(\"_thread\");\n  const selectionKind = thread ? (\"threads\" as const) : (\"messages\" as const);\n  const ids =\n    thread && typeof args.threadId === \"string\"\n      ? [args.threadId]\n      : Array.isArray(args.messageIds)\n        ? args.messageIds\n        : typeof args.messageId === \"string\"\n          ? [args.messageId]\n          : null;\n  const selectionCount = ids?.every((id) => typeof id === \"string\") ? new Set(ids).size : undefined;\n  const noun =\n    selectionCount === undefined\n      ? thread\n        ? \"conversations\"\n        : \"messages\"\n      : `${selectionCount.toLocaleString(\"en-US\")} ${thread ? \"conversation\" : \"message\"}${selectionCount === 1 ? \"\" : \"s\"}`;\n  const addValues = toolName.startsWith(\"label_\") ? args.labelIds : args.addLabelIds;\n  const adds = Array.isArray(addValues)\n    ? addValues.filter((v): v is string => typeof v === \"string\")\n    : [];\n  const removeValues = toolName.startsWith(\"unlabel_\") ? args.labelIds : args.removeLabelIds;\n  const removes = Array.isArray(removeValues)\n    ? removeValues.filter((v): v is string => typeof v === \"string\")\n    : [];\n  const labelEffect = (label: string, adding: boolean): string => {\n    const known: Record<string, [string, string]> = {\n      TRASH: [\"Move to Trash\", \"Remove from Trash\"],\n      INBOX: [\"Move to Inbox\", \"Remove from Inbox\"],\n      UNREAD: [\"Mark as unread\", \"Mark as read\"],\n      STARRED: [\"Add star\", \"Remove star\"],\n      SPAM: [\"Mark as spam\", \"Remove from Spam\"],\n      IMPORTANT: [\"Mark as important\", \"Remove importance\"],\n    };\n    return (\n      (Object.hasOwn(known, label) ? known[label]?.[adding ? 0 : 1] : undefined) ??\n      `${adding ? \"Add\" : \"Remove\"} label ${bound(label, 120)}`\n    );\n  };\n  const effects = [\n    ...adds.map((id) => labelEffect(id, true)),\n    ...removes.map((id) => labelEffect(id, false)),\n  ];\n  if (\n    [\n      \"batch_modify_messages\",\n      \"modify_message\",\n      \"modify_thread\",\n      \"label_message\",\n      \"label_thread\",\n      \"unlabel_message\",\n      \"unlabel_thread\",\n    ].includes(toolName)\n  ) {\n    const trash = adds.includes(\"TRASH\");\n    return {\n      title: trash ? `Move ${noun} to Trash` : `Update ${noun}`,\n      approveLabel: trash ? \"Move to Trash\" : \"Apply changes\",\n      effects,\n      ...(selectionCount === undefined ? {} : { selectionCount, selectionKind }),\n      ...(trash\n        ? { consequence: \"Messages stay recoverable in Trash until Gmail deletes them.\" }\n        : thread\n          ? { consequence: \"Applies to every message in the conversation.\" }\n          : {}),\n    };\n  }\n  if ([\"trash_message\", \"restore_message\", \"trash_thread\", \"restore_thread\"].includes(toolName))\n    return {\n      title: toolName.startsWith(\"trash_\") ? `Move ${noun} to Trash` : `Remove ${noun} from Trash`,\n      approveLabel: toolName.startsWith(\"trash_\") ? \"Move to Trash\" : \"Remove from Trash\",\n      effects,\n      ...(selectionCount === undefined ? {} : { selectionCount, selectionKind }),\n    };\n  const named: Record<string, [string, string]> = {\n    send_message: [\"Send email\", \"Send email\"],\n    send_draft: [\"Send draft\", \"Send draft\"],\n    create_draft: [\"Create email draft\", \"Create draft\"],\n    update_draft: [\"Update email draft\", \"Update draft\"],\n    delete_draft: [\"Delete email draft\", \"Delete draft\"],\n    create_label: [\"Create label\", \"Create label\"],\n    update_label: [\"Update label\", \"Update label\"],\n    delete_label: [\"Delete label\", \"Delete label\"],\n  };\n  const action = Object.hasOwn(named, toolName) ? named[toolName] : undefined;\n  return action ? { title: action[0], approveLabel: action[1], effects } : fallback;\n}\n\n/** A bounded slice of the immutable saved arguments; never evaluates a fresh provider query. */\nexport function toolReviewDetails(\n  argumentsValue: unknown,\n  context: ToolReviewContext | undefined,\n  path: string,\n  offset: number,\n  limit = 25,\n): Omit<ToolReviewDetailsPage, \"id\" | \"actionDigest\" | \"version\"> {\n  if (\n    !Number.isSafeInteger(offset) ||\n    offset < 0 ||\n    !Number.isSafeInteger(limit) ||\n    limit < 1 ||\n    limit > 50\n  )\n    throw new Error(\"Invalid review page\");\n  const args = decodeReviewArguments(argumentsValue);\n  let value: unknown = context?.email ? { ...args, $email: context.email } : args;\n  if (path !== \"\") {\n    if (!path.startsWith(\"/\")) throw new Error(\"Invalid review field\");\n    for (const escaped of path.slice(1).split(\"/\")) {\n      if (/^~2\\d+$/.test(escaped)) {\n        if (!value || typeof value !== \"object\" || Array.isArray(value))\n          throw new Error(\"Review field not found\");\n        const selected = Object.entries(value)[Number(escaped.slice(2))];\n        if (!selected) throw new Error(\"Review field not found\");\n        value = {\n          fieldName: selected[0],\n          value: protectedReviewField(selected[0], context?.protectedFields)\n            ? \"[Protected value]\"\n            : selected[1],\n        };\n        continue;\n      }\n      const key = escaped.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\");\n      if (protectedReviewField(key, context?.protectedFields)) {\n        value = \"[Protected value]\";\n        break;\n      }\n      if (!value || typeof value !== \"object\" || !Object.hasOwn(value, key))\n        throw new Error(\"Review field not found\");\n      value = (value as Record<string, unknown>)[key];\n    }\n  }\n  type DetailItem = ToolReviewDetailsPage[\"items\"][number];\n  const preview = (\n    entry: unknown,\n    key: string,\n    childPath: string,\n  ): Pick<DetailItem, \"value\" | \"truncated\" | \"path\"> => {\n    const hidden = protectedReviewField(key, context?.protectedFields);\n    if (!hidden && entry !== null && typeof entry === \"object\") {\n      const count = Array.isArray(entry) ? entry.length : Object.keys(entry).length;\n      return {\n        value: `${count.toLocaleString(\"en-US\")} ${Array.isArray(entry) ? (count === 1 ? \"item\" : \"items\") : count === 1 ? \"field\" : \"fields\"}`,\n        path: childPath,\n        truncated: true,\n      };\n    }\n    const text = valueText(safeReviewValue(entry, key, context?.protectedFields));\n    return {\n      value: bound(text, 4000),\n      ...(hidden ? {} : { path: childPath }),\n      truncated: !hidden && text.length > 4000,\n    };\n  };\n  let total: number;\n  let items: DetailItem[];\n  if (Array.isArray(value)) {\n    total = value.length;\n    items = value.slice(offset, offset + limit).map((entry, index) => ({\n      label: `${offset + index + 1}`,\n      ...preview(entry, \"\", `${path}/${offset + index}`),\n    }));\n  } else if (value && typeof value === \"object\") {\n    const entries = Object.entries(value);\n    total = entries.length;\n    items = entries.slice(offset, offset + limit).map(([key, entry], index) => ({\n      label: bound(\n        (context?.fieldLabels && Object.hasOwn(context.fieldLabels, key)\n          ? context.fieldLabels[key]\n          : undefined) ?? toolReviewFieldLabel(key),\n        256,\n      ),\n      ...preview(entry, key, `${path}${fieldPointer(key, offset + index, path)}`),\n    }));\n  } else {\n    const text = valueText(value);\n    total = Math.max(1, Math.ceil(text.length / 4000));\n    items = Array.from({ length: Math.max(0, Math.min(limit, total - offset)) }, (_, index) => ({\n      label: `Part ${offset + index + 1}`,\n      value: text.slice((offset + index) * 4000, (offset + index + 1) * 4000),\n    }));\n  }\n  return { path, items, total, nextOffset: offset + limit < total ? offset + limit : null };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-TLU3UEMD.js

@@ -0,0 +1,324 @@
+// src/site-operations.ts
+var ID = "[A-Za-z0-9_-]{1,128}";
+var DATA = "/published-artifacts/current/(?:data|files)(?:/[A-Za-z0-9._~:@!$&'()*+,;=-]+)*";
+var SITE_OPERATIONS = Object.freeze([
+  { id: "config.client", method: "GET", pattern: /^\/v1\/config\/client$/u },
+  { id: "workspace.get", method: "GET", pattern: /^$/u },
+  { id: "site.config", method: "GET", pattern: /^\/site\/config$/u },
+  { id: "models.list", method: "GET", pattern: /^\/model-catalog$/u },
+  { id: "sessions.list", method: "GET", pattern: /^\/sessions$/u },
+  { id: "sessions.create", method: "POST", pattern: /^\/sessions$/u, agent: true },
+  { id: "sessions.get", method: "GET", pattern: new RegExp(`^/sessions/${ID}$`, "u") },
+  { id: "sessions.events", method: "GET", pattern: new RegExp(`^/sessions/${ID}/events$`, "u") },
+  {
+    id: "sessions.stream",
+    method: "GET",
+    pattern: new RegExp(`^/sessions/${ID}/events/stream$`, "u"),
+    stream: true
+  },
+  {
+    id: "sessions.send",
+    method: "POST",
+    pattern: new RegExp(`^/sessions/${ID}/events$`, "u"),
+    agent: true
+  },
+  {
+    id: "sessions.steer",
+    method: "POST",
+    pattern: new RegExp(`^/sessions/${ID}/steer$`, "u"),
+    agent: true
+  },
+  {
+    id: "sessions.control",
+    method: "POST",
+    pattern: new RegExp(`^/sessions/${ID}/control$`, "u"),
+    agent: true
+  },
+  { id: "sessions.queue", method: "GET", pattern: new RegExp(`^/sessions/${ID}/queue$`, "u") },
+  // SessionConversation's documented queue edit/delete/steer/move.
+  {
+    id: "sessions.queue.item",
+    method: "POST",
+    pattern: new RegExp(`^/sessions/${ID}/queue/${ID}/(?:move|edit|steer|delete)$`, "u"),
+    agent: true
+  },
+  // SessionConversation's durable composer draft and its Send.
+  {
+    id: "sessions.composerDraft.get",
+    method: "GET",
+    pattern: new RegExp(`^/sessions/${ID}/composer-draft$`, "u")
+  },
+  {
+    id: "sessions.composerDraft.put",
+    method: "PUT",
+    pattern: new RegExp(`^/sessions/${ID}/composer-draft$`, "u")
+  },
+  {
+    id: "sessions.composerDraft.submit",
+    method: "POST",
+    pattern: new RegExp(`^/sessions/${ID}/composer-draft/submit$`, "u"),
+    agent: true
+  },
+  {
+    id: "sessions.humanInput",
+    method: "GET",
+    pattern: new RegExp(`^/sessions/${ID}/human-input-requests$`, "u")
+  },
+  // SessionConversation's human-input form reads the one open request.
+  {
+    id: "sessions.humanInput.get",
+    method: "GET",
+    pattern: new RegExp(`^/sessions/${ID}/human-input-requests/${ID}$`, "u")
+  },
+  { id: "data.read", method: "GET", pattern: new RegExp(`^${DATA}$`, "u") },
+  { id: "data.write", method: "POST", pattern: new RegExp(`^${DATA}$`, "u") },
+  { id: "data.put", method: "PUT", pattern: new RegExp(`^${DATA}$`, "u") },
+  { id: "data.patch", method: "PATCH", pattern: new RegExp(`^${DATA}$`, "u") },
+  { id: "data.delete", method: "DELETE", pattern: new RegExp(`^${DATA}$`, "u") },
+  // Site SQL (PR B): run one named query the owner defined; never raw SQL.
+  {
+    id: "sql.run",
+    method: "POST",
+    pattern: /^\/published-artifacts\/current\/sql\/queries\/[A-Za-z][A-Za-z0-9_-]{0,63}$/u
+  },
+  { id: "site.report", method: "POST", pattern: /^\/site\/reports$/u }
+]);
+var SITE_TOOL_METHODS = Object.freeze([
+  "catalog",
+  "declarations",
+  "call",
+  "resolve",
+  "invoke"
+]);
+var SITE_HOST_PREFIX = "/v1/workspaces/site-host";
+function matchSiteOperation(method, path) {
+  if (/[%\\#\u0000-\u0020\u007f]/u.test(path)) return null;
+  if (path.split("/").some((part) => part === "." || part === "..")) return null;
+  const upper = method.toUpperCase();
+  let suffix;
+  if (path === "/v1/config/client") suffix = path;
+  else if (path === SITE_HOST_PREFIX) suffix = "";
+  else if (path.startsWith(`${SITE_HOST_PREFIX}/`)) suffix = path.slice(SITE_HOST_PREFIX.length);
+  else return null;
+  const operation = SITE_OPERATIONS.find(
+    (candidate) => candidate.method === upper && candidate.pattern.test(suffix)
+  );
+  return operation ? { operation, suffix } : null;
+}
+
+// src/site-session-http.ts
+var SITE_WORKSPACE_PREFIX = "/v1/workspaces/site-host";
+var SITE_DATA_PATH = /^\/v1\/workspaces\/site-host\/published-artifacts\/([^/]+)\/(?:data|files|sql)(?:\/|$)/u;
+var SITE_NO_ORIGIN_ID = "00000000-0000-0000-0000-000000000000";
+var SITE_FRAME_HEADER = "x-opengeni-site-frame";
+var SITE_PREVIEW_FRAME = "preview";
+var SITE_FRAME_ID_HEADER = "x-opengeni-site-frame-id";
+var SITE_ID_HEADER = "x-opengeni-site-id";
+var SITE_VERSION_HEADER = "x-opengeni-site-version";
+var SiteSessionPathError = class extends Error {
+  code = "site_session_path_unsupported";
+  constructor() {
+    super("Unsupported Site session API path");
+    this.name = "SiteSessionPathError";
+  }
+};
+var SiteDataUnsupportedError = class extends Error {
+  code = "site_data_unsupported";
+  constructor() {
+    super("This Site host does not provide Site Data");
+    this.name = "SiteDataUnsupportedError";
+  }
+};
+function unsafePathname(pathname) {
+  return /[%\\#\u0000-\u0020\u007f]/u.test(pathname) || pathname.split("/").some((part) => part === "." || part === "..");
+}
+function hostWorkspacePath(path, workspaceId) {
+  return path.replace("/workspaces/site-host", `/workspaces/${encodeURIComponent(workspaceId)}`);
+}
+function siteDataPath(path, rewritten, workspaceId, siteId) {
+  if (workspaceId === "site-host") return path;
+  if (!siteId) throw new SiteDataUnsupportedError();
+  return rewritten.replace(
+    "/published-artifacts/current/",
+    `/published-artifacts/${encodeURIComponent(siteId)}/`
+  );
+}
+function siteSessionPath(path, workspaceId, method = "GET", siteId) {
+  const pathname = path.split("?")[0];
+  const match = matchSiteOperation(method, pathname);
+  if (!match) throw new SiteSessionPathError();
+  const rewritten = hostWorkspacePath(path, workspaceId);
+  if (SITE_DATA_PATH.test(pathname)) return siteDataPath(path, rewritten, workspaceId, siteId);
+  if (match.operation.id !== "sessions.list") return rewritten;
+  const url = new URL(rewritten, "http://site.invalid");
+  const origins = url.searchParams.getAll("originSiteId");
+  if (origins.length !== 1 || origins[0] !== "current") throw new SiteSessionPathError();
+  if (workspaceId === "site-host") return path;
+  url.searchParams.set("originSiteId", siteId ?? SITE_NO_ORIGIN_ID);
+  return url.pathname + url.search;
+}
+function siteHostWorkspacePath(path, workspaceId) {
+  const pathname = path.split("?")[0];
+  const workspace = pathname === SITE_WORKSPACE_PREFIX || pathname.startsWith(`${SITE_WORKSPACE_PREFIX}/`);
+  if (!workspace && pathname !== "/v1/config/client" || unsafePathname(pathname))
+    throw new SiteSessionPathError();
+  const rewritten = hostWorkspacePath(path, workspaceId);
+  const data = SITE_DATA_PATH.exec(pathname);
+  if (data) {
+    if (data[1] !== "current") throw new SiteSessionPathError();
+    return siteDataPath(path, rewritten, workspaceId);
+  }
+  const url = new URL(rewritten, "http://site.invalid");
+  if (url.searchParams.get("originSiteId") === "current" && workspaceId !== "site-host") {
+    url.searchParams.set("originSiteId", SITE_NO_ORIGIN_ID);
+    return url.pathname + url.search;
+  }
+  return rewritten;
+}
+function siteFrameFromHeaders(header) {
+  const value = (name) => header(name) ?? null;
+  const marker = value(SITE_FRAME_HEADER);
+  const siteId = value(SITE_ID_HEADER);
+  const versionId = value(SITE_VERSION_HEADER);
+  const frameId = value(SITE_FRAME_ID_HEADER);
+  if (marker === null && siteId === null && versionId === null && frameId === null) return null;
+  return { siteId: siteId || null, versionId: versionId || null, marker, frameId: frameId || null };
+}
+function siteFrameOperation(method, pathname, workspaceId, frameSiteId) {
+  if (unsafePathname(pathname)) return null;
+  let sitePath = pathname;
+  if (pathname !== "/v1/config/client") {
+    const prefix = `/v1/workspaces/${workspaceId}`;
+    if (pathname !== prefix && !pathname.startsWith(`${prefix}/`)) return null;
+    sitePath = `${SITE_WORKSPACE_PREFIX}${pathname.slice(prefix.length)}`;
+    const data = /^\/v1\/workspaces\/site-host\/published-artifacts\/([^/]+)\//u.exec(sitePath);
+    if (data) {
+      if (!frameSiteId || data[1] !== frameSiteId) return null;
+      sitePath = sitePath.replace(
+        `/published-artifacts/${frameSiteId}/`,
+        "/published-artifacts/current/"
+      );
+    }
+  }
+  const match = matchSiteOperation(method, sitePath);
+  if (!match) return null;
+  const session = /^\/sessions\/([^/]+)(?:\/|$)/u.exec(match.suffix);
+  return { ...match, sessionId: session ? session[1] : null };
+}
+function siteRequestHeaders(input) {
+  const headers = new Headers(input);
+  const connectionHeaders = (headers.get("connection") ?? "").split(",").map((value) => value.trim().toLowerCase());
+  for (const name of [...headers.keys()]) {
+    if (connectionHeaders.includes(name) || /^(authorization|proxy-authorization|cookie|cookie2|host|origin|referer|connection|keep-alive|proxy-connection|te|trailer|transfer-encoding|upgrade|content-length|accept-encoding|forwarded|x-api-key)$/i.test(
+      name
+    ) || /^(sec-|x-forwarded-|x-opengeni-(access-key|external-actor|site-|managed-actor))/i.test(name))
+      headers.delete(name);
+  }
+  return headers;
+}
+var SITE_FRAME_MESSAGE_FIELDS = [
+  "text",
+  "annotations",
+  "model",
+  "reasoningEffort",
+  "latencyMode",
+  "controlEtag",
+  "expectedDraftRevision"
+];
+var SITE_FRAME_BODY_FIELDS = Object.freeze({
+  "sessions.send": ["type", "payload", "clientEventId"],
+  "sessions.steer": [...SITE_FRAME_MESSAGE_FIELDS, "clientEventId"],
+  "sessions.control": ["action", "reason", "clientEventId", "expectedControlEtag"],
+  "sessions.composerDraft.put": [
+    "text",
+    "annotations",
+    "resources",
+    "model",
+    "reasoningEffort",
+    "latencyMode",
+    "expectedRevision"
+  ],
+  "sessions.composerDraft.submit": [
+    ...SITE_FRAME_MESSAGE_FIELDS,
+    "resources",
+    "connectionAccounts",
+    "clientEventId",
+    "delivery"
+  ],
+  "sessions.queue.move": ["clientEventId", "expectedQueueVersion", "beforeTurnId"],
+  "sessions.queue.edit": [
+    "clientEventId",
+    "expectedTurnVersion",
+    "expectedDraftRevision",
+    "replaceDraft"
+  ],
+  "sessions.queue.steer": ["clientEventId", "expectedTurnVersion", "controlEtag"],
+  "sessions.queue.delete": ["clientEventId", "expectedTurnVersion", "reason"]
+});
+var SITE_FRAME_EMPTY_ONLY_FIELDS = /* @__PURE__ */ new Set(["resources", "connectionAccounts"]);
+var SITE_FRAME_SESSION_CREATE_FIELDS = Object.freeze([
+  "initialMessage",
+  "requestedSessionId",
+  "idempotencyKey",
+  "clientEventId",
+  "model",
+  "reasoningEffort",
+  "latencyMode",
+  "startMode",
+  "metadata"
+]);
+function bodyRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function emptyBodyValue(value) {
+  if (value === void 0 || value === null) return true;
+  if (Array.isArray(value)) return value.length === 0;
+  if (typeof value === "object") return Object.keys(value).length === 0;
+  return false;
+}
+function refusedField(body, allowed, prefix = "") {
+  for (const [name, value] of Object.entries(body)) {
+    if (emptyBodyValue(value)) continue;
+    if (!allowed.includes(name) || SITE_FRAME_EMPTY_ONLY_FIELDS.has(name))
+      return `${prefix}${name}`;
+  }
+  return null;
+}
+function siteFrameBodyRefusal(operationId, suffix, body) {
+  const record = bodyRecord(body);
+  if (!record) return null;
+  if (operationId === "sessions.create")
+    return refusedField(record, SITE_FRAME_SESSION_CREATE_FIELDS);
+  const action = operationId === "sessions.queue.item" ? /\/queue\/[^/]+\/(move|edit|steer|delete)$/u.exec(suffix)?.[1] : void 0;
+  const key = action ? `sessions.queue.${action}` : operationId;
+  const allowed = SITE_FRAME_BODY_FIELDS[key];
+  if (!allowed) return null;
+  const refused = refusedField(record, allowed);
+  if (refused) return refused;
+  if (operationId !== "sessions.send") return null;
+  if (record.type !== "user.message") return "type";
+  const payload = bodyRecord(record.payload);
+  return payload ? refusedField(payload, SITE_FRAME_MESSAGE_FIELDS, "payload.") : null;
+}
+
+export {
+  SITE_OPERATIONS,
+  SITE_TOOL_METHODS,
+  matchSiteOperation,
+  SITE_NO_ORIGIN_ID,
+  SITE_FRAME_HEADER,
+  SITE_PREVIEW_FRAME,
+  SITE_FRAME_ID_HEADER,
+  SITE_ID_HEADER,
+  SITE_VERSION_HEADER,
+  SiteSessionPathError,
+  SiteDataUnsupportedError,
+  siteSessionPath,
+  siteHostWorkspacePath,
+  siteFrameFromHeaders,
+  siteFrameOperation,
+  siteRequestHeaders,
+  SITE_FRAME_SESSION_CREATE_FIELDS,
+  siteFrameBodyRefusal
+};
+//# sourceMappingURL=chunk-TLU3UEMD.js.map