@emseepea/testing 0.23.5 → 0.24.0

package/README.md

@@ -109,10 +109,14 @@ EMSEEPEA_CODEX_MODEL=gpt-5.5 emseepea-test --provider codex-local eval
 
 `codex-local` uses the existing Codex CLI sign-in without copying it.
 `codex-ci` requires `OPENAI_API_KEY` from the CI secret store. Both providers
-support Codex CLI 0.162.0 or later, run `codex exec --json`, resume the actual
+record the installed CLI version as provenance, run `codex exec --json`, resume the actual
 Codex session for follow-ups, ignore user configuration, and pre-approve only
 the discovered tools from the test server.
 
+CLI eligibility is established by the invocation and event contracts rather
+than a version cutoff. An unsupported invocation or invalid, incomplete or
+forbidden event still fails qualification.
+
 An isolated command policy denies shell launches and spawned shell environments
 inherit no provider credentials. The runner also disables Codex account apps,
 plugins, remote plugins, multi-agent execution, web search, shell tools, and
@@ -611,3 +615,116 @@ retained. Known configured authentication values are scrubbed from elicitation
 evidence. Arbitrary secrets placed inside test content are not detected.
 Local evidence is written with mode `0600`; repository CI retains it for 14
 days.
+
+## Opt In to Native ChatGPT Browser Journeys
+
+Import `@emseepea/testing/chatgpt` only when you want to test the real ChatGPT
+web experience. Ordinary framework tests do not enable this adapter or install
+Playwright. This is an experimental browser
+adapter: ChatGPT controls can change, and live host qualification is pending.
+
+On your own machine, install the optional browser tooling:
+
+```sh
+npm install --save-dev @emseepea/testing playwright@1.62.1
+npx playwright install chromium
+npx emseepea-chatgpt-setup --enable-native-chatgpt --account-owner '<test-account-owner>'
+```
+
+Before publication, run the source checkout with
+`node packages/testing/chatgpt/setup.mjs` using the same arguments.
+
+The setup command opens a dedicated headed browser. Sign in to the authorized
+ChatGPT test account, complete MFA, check the account, and type `READY` in the
+terminal. Codex CLI login does not sign in to ChatGPT.
+
+If bundled Chromium
+cannot complete your account login, use `--browser-channel chrome` with an
+installed Chrome browser. The profile defaults to `~/.emseepea/chatgpt-browser`;
+keep it outside the repository and CI artifacts.
+
+The command verifies a
+signed-in control, not the account's identity; the human confirms that identity.
+If that control changes, pass an account-specific `--authenticated-selector`.
+
+Connect your authorized HTTPS MCP endpoint through ChatGPT's current plugin
+installation flow. Complete account consent yourself. A local server requires
+a supported HTTPS tunnel before ChatGPT can reach it. See the
+[official ChatGPT connection instructions](https://developers.openai.com/plugins/deploy/connect-chatgpt).
+
+Use synthetic fixtures and a dedicated account; starting a fresh conversation
+does not disable account memory. This package does not create an endpoint,
+install a plugin, grant consent, or infer client identity from a user agent.
+
+Create an adopter-owned `.mjs` scenario module that exports `authorization` and
+`createJourney({ page, runId })`. The authorization declares `approved: true`,
+`fixturePolicy: "synthetic"`, an HTTPS `endpoint: new URL(...)`, and the
+`accountOwner`, `endpointOwner`, `fixtureOwner`, and `cleanupOwner` strings.
+
+
+Use the same account owner as setup. `createJourney` returns `checkpoints` and
+an asynchronous `cleanup(signal)` callback. The callback must confirm both
+`fixturesRemoved: true` and `conversationsRemoved: true` after observing cleanup.
+
+The CLI supplies the explicit enable flag, authorized page, run ID, and ownership.
+
+```sh
+npx emseepea-chatgpt --enable-native-chatgpt --scenario ./native-chatgpt.mjs
+```
+
+Before publication, use `node packages/testing/chatgpt/run.mjs` after building
+the package. The command reuses the private profile and writes evidence to
+`artifacts/native-chatgpt/evidence.json`. Exit code 0 means passed, 1 means an
+assertion failed, and 2 means blocked or incomplete.
+
+The exported `NativeChatGptJourneyModule` type describes the scenario contract.
+For direct integration, use `defineNativeChatGptJourney` and
+`runNativeChatGptJourney(journey, outputPath)` with your own authenticated
+Playwright page. The runner never launches a browser by itself. Use these
+checkpoint operations in the order your application requires:
+
+- `human`: wait for the account owner to finish connection or consent.
+- `attach`: upload a synthetic file and observe its ready control.
+- `send`: submit a prompt and assert the completed assistant response.
+- `server-observation`: assert MCP calls after every submitted turn.
+- `visible`, `click`, and `image`: inspect or interact with an application card,
+  including locators inside its iframe. Image assertions receive PNG bytes.
+- `application-state`: compare a declared SHA-256 with independently read state.
+- `fresh-conversation`: start a new conversation, then submit and observe retrieval.
+
+Default controls use ChatGPT's composer and send/stop buttons. Override
+`controls` with locators from the authorized page when the UI changes.
+
+`timeoutMs` bounds each browser operation or callback (default 30 seconds),
+and `clockSkewMs` allows 0–5000 ms between browser and server clocks (default
+1000 ms). A callback must respect its abort signal; timing it out cannot undo
+an operation already sent to a server.
+
+A server collector receives `runId`, `afterSequence`, `since`, and `signal`.
+Return ordered, run-scoped calls matching the declared method, target, outcome,
+and optional result hash. Each call includes request/result SHA-256 values,
+endpoint SHA-256, sequence, timestamp, and `nativeClient`.
+
+Set
+`nativeClient: "verified-chatgpt"` only when your authenticated server boundary
+establishes that the request came through the dedicated ChatGPT connection;
+use `"unverified"` otherwise.
+
+A user agent, browser answer, or simulator record
+cannot establish this. Define your run correlation and authenticated boundary
+before attempting live qualification. An unavailable collector or unverified
+client produces incomplete evidence.
+
+Evidence retains bounded hashes and fixed failure categories. It omits raw
+prompts, replies, endpoint addresses, ownership strings, cookies, and arbitrary
+observer metadata. Explicit `image` checkpoints save scoped PNGs alongside
+the evidence; review the selected card for private content before enabling one.
+
+Files use mode `0600`. Store evidence privately and choose your own retention
+policy. Cleanup is required even after an assertion fails.
+
+The package's scripted-page and intercepted Chromium tests verify the adapter
+contract. They do not prove compatibility with live ChatGPT. Qualify connection,
+real MCP invocation, visible card, durable application state, fresh retrieval,
+and cleanup against your owned account and endpoint before claiming that host
+journey works.

package/chatgpt/run.mjs

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { createHash, randomUUID } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+
+const help = `Usage: emseepea-chatgpt --enable-native-chatgpt --scenario <owned-module.mjs>
+  [--profile <dedicated-directory>] [--output <private-evidence.json>]
+
+The module exports authorization and createJourney({ page, runId }). It owns
+its assertions, server observations, and cleanup. Complete human setup first.
+This command never logs in, grants consent, or exports authentication state.
+`;
+
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.includes("--help")) { console.log(help); return; }
+  if (args.filter((arg) => arg === "--enable-native-chatgpt").length !== 1) throw new Error("explicit-opt-in-required");
+  const values = new Map();
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--enable-native-chatgpt") continue;
+    if (!["--scenario", "--profile", "--output"].includes(arg) || values.has(arg) || !args[index + 1] || args[index + 1].startsWith("--")) throw new Error("invalid-run-options");
+    values.set(arg, args[++index]);
+  }
+  if (!values.get("--scenario")) throw new Error("owned-scenario-required");
+  const scenario = await import(pathToFileURL(resolve(values.get("--scenario"))).href);
+  if (typeof scenario.createJourney !== "function" || scenario.authorization?.approved !== true || typeof scenario.authorization.accountOwner !== "string") throw new Error("owned-scenario-required");
+  const profile = resolve(values.get("--profile") ?? join(homedir(), ".emseepea", "chatgpt-browser"));
+  const record = await readFile(join(profile, "emseepea-profile.json"), "utf8").then(JSON.parse).catch(() => undefined);
+  const ownerSha256 = createHash("sha256").update(scenario.authorization.accountOwner).digest("hex");
+  if (record?.schemaVersion !== 1 || record?.humanConfirmed !== true || record?.ownerSha256 !== ownerSha256 || !["chromium", "chrome", "msedge"].includes(record?.channel)) throw new Error("human-setup-required");
+  let chromium;
+  try { ({ chromium } = await import("playwright")); }
+  catch { throw new Error("optional-playwright-dependency-required"); }
+  const { runNativeChatGptJourney } = await import("../dist/chatgpt.js");
+  let context;
+  try { context = await chromium.launchPersistentContext(profile, { headless: false, ...(record.channel === "chromium" ? {} : { channel: record.channel }) }); }
+  catch { throw new Error("headed-browser-unavailable"); }
+  try {
+    const page = context.pages()[0] ?? await context.newPage();
+    await page.goto("https://chatgpt.com/", { waitUntil: "domcontentloaded" });
+    const runId = randomUUID();
+    const declared = await scenario.createJourney({ page, runId });
+    const evidence = await runNativeChatGptJourney({ ...declared, enabled: true, page, runId, authorization: scenario.authorization },
+      resolve(values.get("--output") ?? "artifacts/native-chatgpt/evidence.json"));
+    console.log(`Native ChatGPT journey ${evidence.status}. Evidence written privately.`);
+    if (evidence.status !== "passed") process.exitCode = evidence.status === "failed" ? 1 : 2;
+  } finally { await context.close(); }
+}
+
+main().catch((error) => {
+  const categories = new Set(["explicit-opt-in-required", "invalid-run-options", "owned-scenario-required", "human-setup-required", "optional-playwright-dependency-required", "headed-browser-unavailable"]);
+  console.error(`Native ChatGPT journey blocked: ${categories.has(error.message) ? error.message : "journey-unavailable"}`);
+  process.exitCode = 2;
+});

package/chatgpt/setup.mjs

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import { createHash } from "node:crypto";
+import { chmod, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
+
+const help = `Usage: emseepea-chatgpt-setup --enable-native-chatgpt --account-owner <owner>
+  [--profile <dedicated-directory>] [--authenticated-selector <CSS selector>]
+  [--browser-channel chromium|chrome|msedge]
+
+Opens a headed ChatGPT browser for human login and consent. Authentication stays
+in the private local profile; it is never exported to evidence or a repository.
+Install the optional playwright@1.62.1 dependency and its Chromium browser first.
+`;
+
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.includes("--help")) { console.log(help); return; }
+  if (args.filter((arg) => arg === "--enable-native-chatgpt").length !== 1) throw new Error("explicit-opt-in-required");
+  const values = new Map();
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--enable-native-chatgpt") continue;
+    if (!["--account-owner", "--profile", "--authenticated-selector", "--browser-channel"].includes(arg) || values.has(arg) || !args[index + 1] || args[index + 1].startsWith("--")) throw new Error("invalid-setup-options");
+    values.set(arg, args[++index]);
+  }
+  const owner = values.get("--account-owner");
+  if (!owner?.trim() || owner.length > 256) throw new Error("account-owner-required");
+  if (!process.stdin.isTTY) throw new Error("interactive-local-terminal-required");
+  const selector = values.get("--authenticated-selector") ?? '[data-testid="accounts-profile-button"]';
+  if (selector.length > 1024) throw new Error("invalid-setup-options");
+  const channel = values.get("--browser-channel") ?? "chromium";
+  if (!["chromium", "chrome", "msedge"].includes(channel)) throw new Error("invalid-setup-options");
+  let chromium;
+  try { ({ chromium } = await import("playwright")); }
+  catch { throw new Error("optional-playwright-dependency-required"); }
+  const profile = resolve(values.get("--profile") ?? join(homedir(), ".emseepea", "chatgpt-browser"));
+  const marker = join(profile, "emseepea-profile.json");
+  const ownerSha256 = createHash("sha256").update(owner).digest("hex");
+  await mkdir(profile, { recursive: true, mode: 0o700 });
+  const existing = await readdir(profile);
+  if (existing.length) {
+    const record = await readFile(marker, "utf8").then(JSON.parse).catch(() => undefined);
+    if (record?.schemaVersion !== 1 || record?.ownerSha256 !== ownerSha256) throw new Error("dedicated-owned-profile-required");
+  }
+  {
+    await writeFile(marker, `${JSON.stringify({ schemaVersion: 1, ownerSha256, humanConfirmed: false, channel })}\n`, { mode: 0o600 });
+  }
+  await chmod(profile, 0o700);
+  let context;
+  try { context = await chromium.launchPersistentContext(profile, { headless: false, ...(channel === "chromium" ? {} : { channel }) }); }
+  catch { throw new Error("headed-browser-unavailable"); }
+  const terminal = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const page = context.pages()[0] ?? await context.newPage();
+    await page.goto("https://chatgpt.com/", { waitUntil: "domcontentloaded" });
+    console.log("Sign in to the authorized test account in the browser. Complete MFA and any consent yourself.");
+    const confirmation = await terminal.question("After checking the account, type READY to verify the signed-in control: ");
+    if (confirmation !== "READY") throw new Error("human-confirmation-required");
+    if (new URL(page.url()).origin !== "https://chatgpt.com") throw new Error("native-chatgpt-page-required");
+    try { await page.locator(selector).waitFor({ state: "visible", timeout: 10_000 }); }
+    catch { throw new Error("signed-in-control-unobserved"); }
+    await writeFile(marker, `${JSON.stringify({ schemaVersion: 1, ownerSha256, humanConfirmed: true, channel })}\n`, { mode: 0o600 });
+    await chmod(marker, 0o600);
+    console.log("Signed-in control observed. The dedicated local profile is ready for explicitly enabled journeys.");
+  } finally {
+    terminal.close();
+    await context.close();
+  }
+}
+
+main().catch((error) => {
+  // Never print browser errors, headers, cookies, account metadata, or credentials.
+  const categories = new Set(["explicit-opt-in-required", "invalid-setup-options", "account-owner-required",
+    "interactive-local-terminal-required", "optional-playwright-dependency-required", "dedicated-owned-profile-required",
+    "headed-browser-unavailable", "human-confirmation-required", "native-chatgpt-page-required", "signed-in-control-unobserved"]);
+  console.error(`ChatGPT setup blocked: ${categories.has(error.message) ? error.message : "setup-unavailable"}`);
+  console.error(help);
+  process.exitCode = 2;
+});

package/dist/chatgpt.d.ts

@@ -0,0 +1,132 @@
+import type { Locator, Page } from "playwright";
+export type NativeChatGptStatus = "passed" | "failed" | "blocked" | "incomplete";
+export type NativeChatGptMethod = "initialize" | "tools/list" | "tools/call" | "resources/list" | "resources/templates/list" | "resources/read" | "prompts/list" | "prompts/get" | "notifications/cancelled";
+export interface NativeChatGptAuthorization {
+    readonly approved: true;
+    readonly accountOwner: string;
+    readonly endpointOwner: string;
+    readonly fixtureOwner: string;
+    readonly cleanupOwner: string;
+    readonly fixturePolicy: "synthetic";
+    readonly endpoint: URL;
+}
+export interface NativeChatGptControls {
+    readonly composer: Locator;
+    readonly submit: Locator;
+    readonly assistantMessages: Locator;
+    readonly conversationMessages: Locator;
+    readonly generating: Locator;
+    readonly fileInput: Locator;
+}
+export interface NativeChatGptServerCall {
+    readonly sequence: number;
+    readonly runId: string;
+    readonly endpointSha256: string;
+    /** Established by the server's authenticated client boundary, never user-agent text. */
+    readonly nativeClient: "verified-chatgpt" | "unverified";
+    readonly observedAt: string;
+    readonly method: NativeChatGptMethod;
+    readonly target: string;
+    readonly requestSha256: string;
+    readonly responseSha256: string;
+    readonly outcome: "success" | "denied" | "cancelled";
+}
+export interface NativeChatGptObservationContext {
+    readonly runId: string;
+    readonly afterSequence: number;
+    readonly since: string;
+    readonly signal: AbortSignal;
+}
+interface CheckpointBase {
+    readonly id: string;
+}
+export type NativeChatGptCheckpoint = (CheckpointBase & {
+    readonly operation: "human";
+    readonly ready: (signal: AbortSignal) => Promise<boolean>;
+}) | (CheckpointBase & {
+    readonly operation: "fresh-conversation";
+}) | (CheckpointBase & {
+    readonly operation: "click";
+    readonly target: Locator;
+}) | (CheckpointBase & {
+    readonly operation: "attach";
+    readonly file: string;
+    readonly mimeType: string;
+    readonly ready: Locator;
+}) | (CheckpointBase & {
+    readonly operation: "send";
+    readonly prompt: string;
+    readonly expectResponse: (text: string) => boolean | Promise<boolean>;
+}) | (CheckpointBase & {
+    readonly operation: "visible";
+    readonly target: Locator;
+}) | (CheckpointBase & {
+    readonly operation: "image";
+    readonly target: Locator;
+    readonly assertImage: (png: Buffer) => boolean | Promise<boolean>;
+}) | (CheckpointBase & {
+    readonly operation: "application-state";
+    readonly expectedSha256: string;
+    readonly readState: (signal: AbortSignal) => Promise<string>;
+}) | (CheckpointBase & {
+    readonly operation: "server-observation";
+    readonly expectedCalls: readonly {
+        readonly method: NativeChatGptMethod;
+        readonly target: string;
+        readonly outcome: NativeChatGptServerCall["outcome"];
+        readonly responseSha256?: string;
+    }[];
+    readonly collect: (context: NativeChatGptObservationContext) => Promise<readonly NativeChatGptServerCall[]>;
+});
+export interface NativeChatGptJourney {
+    /** Importing the opt-in entry point alone does not authorize execution. */
+    readonly enabled: true;
+    readonly runId: string;
+    /** The adopter supplies an already authenticated, dedicated browser page. */
+    readonly page: Page;
+    readonly authorization: NativeChatGptAuthorization;
+    readonly controls?: NativeChatGptControls;
+    readonly checkpoints: readonly NativeChatGptCheckpoint[];
+    readonly timeoutMs?: number;
+    /** Bounded allowance for independently clocked server observations. Defaults to 1000 ms. */
+    readonly clockSkewMs?: number;
+    /** Must remove fixture data and test conversations; profile ownership stays with the adopter. */
+    readonly cleanup: (signal: AbortSignal) => Promise<{
+        readonly fixturesRemoved: true;
+        readonly conversationsRemoved: true;
+    }>;
+}
+export interface NativeChatGptJourneyModule {
+    readonly authorization: NativeChatGptAuthorization;
+    readonly createJourney: (context: {
+        readonly page: Page;
+        readonly runId: string;
+    }) => Promise<Omit<NativeChatGptJourney, "enabled" | "page" | "runId" | "authorization">> | Omit<NativeChatGptJourney, "enabled" | "page" | "runId" | "authorization">;
+}
+export interface NativeChatGptCheckpointEvidence {
+    readonly id: string;
+    readonly operation: NativeChatGptCheckpoint["operation"] | "cleanup";
+    readonly status: NativeChatGptStatus;
+    readonly category: string;
+    readonly observation?: Readonly<Record<string, unknown>>;
+}
+export interface NativeChatGptEvidence {
+    readonly schemaVersion: 1;
+    readonly evidenceKind: "native-chatgpt-browser";
+    readonly status: NativeChatGptStatus;
+    readonly runId: string;
+    readonly endpointSha256: string;
+    readonly ownershipSha256: string;
+    readonly clockSkewMs: number;
+    readonly startedAt: string;
+    readonly finishedAt: string;
+    readonly checkpoints: readonly NativeChatGptCheckpointEvidence[];
+}
+/** Use native DOM controls; callers can replace locators when ChatGPT's UI changes. */
+export declare function nativeChatGptControls(page: Page): NativeChatGptControls;
+/** Preserve type checking for an explicitly enabled, adopter-owned native journey. */
+export declare function defineNativeChatGptJourney(journey: NativeChatGptJourney): NativeChatGptJourney;
+/** No browser is launched, account connected, or authentication state exported by this runner. */
+export declare function runNativeChatGptJourney(journey: NativeChatGptJourney, output: string): Promise<NativeChatGptEvidence>;
+export {};
+//# sourceMappingURL=chatgpt.d.ts.map

package/dist/chatgpt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatgpt.d.ts","sourceRoot":"","sources":["../src/chatgpt.ts"],"names":[],"mappings":"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"}

package/dist/chatgpt.js

@@ -0,0 +1,296 @@
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+const ID = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$/;
+const SHA256 = /^[a-f0-9]{64}$/;
+const METHODS = new Set(["initialize", "tools/list", "tools/call", "resources/list", "resources/templates/list", "resources/read", "prompts/list", "prompts/get", "notifications/cancelled"]);
+const MAX_BYTES = 16 * 1024 * 1024;
+const MAX_TEXT = 64 * 1024;
+const digest = (value) => createHash("sha256").update(value).digest("hex");
+/** Use native DOM controls; callers can replace locators when ChatGPT's UI changes. */
+export function nativeChatGptControls(page) {
+    return Object.freeze({
+        composer: page.locator("#prompt-textarea"),
+        submit: page.getByTestId("send-button"),
+        assistantMessages: page.locator('[data-message-author-role="assistant"]'),
+        conversationMessages: page.locator('[data-message-author-role="user"], [data-message-author-role="assistant"]'),
+        generating: page.getByTestId("stop-button"),
+        fileInput: page.locator('input[type="file"][multiple]'),
+    });
+}
+/** Preserve type checking for an explicitly enabled, adopter-owned native journey. */
+export function defineNativeChatGptJourney(journey) {
+    return journey;
+}
+/** No browser is launched, account connected, or authentication state exported by this runner. */
+export async function runNativeChatGptJourney(journey, output) {
+    validate(journey, output);
+    const controls = journey.controls ?? nativeChatGptControls(journey.page);
+    for (const control of Object.values(controls))
+        requireOwnedLocator(control, journey.page);
+    const timeout = journey.timeoutMs ?? 30_000;
+    const endpointSha256 = digest(journey.authorization.endpoint.href);
+    const ownershipSha256 = digest(JSON.stringify([journey.authorization.accountOwner, journey.authorization.endpointOwner, journey.authorization.fixtureOwner, journey.authorization.cleanupOwner]));
+    // Snapshot declared expectations before a collector can observe actual calls.
+    const steps = journey.checkpoints.map((checkpoint) => checkpoint.operation === "server-observation"
+        ? { ...checkpoint, expectedCalls: checkpoint.expectedCalls.map((call) => ({ method: call.method, target: call.target, outcome: call.outcome, ...(call.responseSha256 ? { responseSha256: call.responseSha256 } : {}) })) }
+        : { ...checkpoint });
+    const startedAt = new Date().toISOString();
+    const clockSkewMs = journey.clockSkewMs ?? 1_000;
+    const checkpoints = [];
+    let sequence = 0;
+    let pendingObservation = false;
+    let priorConversation;
+    let freshRequired = false;
+    let observedCalls = 0;
+    let sentTurns = 0;
+    let since = startedAt;
+    try {
+        for (const checkpoint of steps) {
+            let observation;
+            try {
+                if (checkpoint.operation !== "human")
+                    assertNativeHost(journey.page);
+                switch (checkpoint.operation) {
+                    case "human":
+                        if (await bounded(checkpoint.ready, timeout) !== true)
+                            throw new Outcome("blocked", "human-required");
+                        assertNativeHost(journey.page);
+                        break;
+                    case "fresh-conversation":
+                        if (pendingObservation)
+                            throw new Outcome("incomplete", "unobserved-turn");
+                        priorConversation = conversationId(journey.page.url()) ?? priorConversation;
+                        await journey.page.goto("https://chatgpt.com/", { waitUntil: "domcontentloaded", timeout });
+                        await controls.composer.waitFor({ state: "visible", timeout });
+                        if ((await controls.composer.innerText()).trim())
+                            throw new Outcome("incomplete", "composer-not-empty");
+                        if (await controls.conversationMessages.count() !== 0)
+                            throw new Outcome("incomplete", "fresh-conversation-unconfirmed");
+                        freshRequired = priorConversation !== undefined;
+                        break;
+                    case "click":
+                        since = new Date().toISOString();
+                        await checkpoint.target.click({ timeout });
+                        assertNativeHost(journey.page);
+                        break;
+                    case "attach": {
+                        const info = await stat(checkpoint.file);
+                        if (!info.isFile() || info.size > MAX_BYTES)
+                            throw new Outcome("failed", "fixture-too-large");
+                        const bytes = await readFile(checkpoint.file);
+                        if (bytes.length > MAX_BYTES)
+                            throw new Outcome("failed", "fixture-too-large");
+                        await controls.fileInput.setInputFiles({ name: basename(checkpoint.file), mimeType: checkpoint.mimeType, buffer: bytes }, { timeout });
+                        await checkpoint.ready.waitFor({ state: "visible", timeout });
+                        observation = { fileSha256: digest(bytes), bytes: bytes.length };
+                        break;
+                    }
+                    case "send": {
+                        if (pendingObservation)
+                            throw new Outcome("incomplete", "unobserved-turn");
+                        const before = await controls.assistantMessages.count();
+                        since = new Date().toISOString();
+                        await controls.composer.fill(checkpoint.prompt, { timeout });
+                        await controls.submit.click({ timeout });
+                        const reply = controls.assistantMessages.nth(before);
+                        await reply.waitFor({ state: "visible", timeout });
+                        const text = await completedReply(reply, controls.generating, timeout);
+                        assertNativeHost(journey.page);
+                        const conversation = conversationId(journey.page.url());
+                        if (!conversation || (freshRequired && conversation === priorConversation))
+                            throw new Outcome("incomplete", "fresh-conversation-unconfirmed");
+                        if (await bounded(() => Promise.resolve(checkpoint.expectResponse(text)), timeout) !== true)
+                            throw new Outcome("failed", "response-assertion");
+                        priorConversation = conversation;
+                        freshRequired = false;
+                        pendingObservation = true;
+                        sentTurns += 1;
+                        observation = { promptSha256: digest(checkpoint.prompt), responseSha256: digest(text), conversationSha256: digest(conversation) };
+                        break;
+                    }
+                    case "visible":
+                        await checkpoint.target.waitFor({ state: "visible", timeout });
+                        break;
+                    case "image": {
+                        const box = await checkpoint.target.boundingBox();
+                        if (!box || box.width * box.height > 4_000_000)
+                            throw new Outcome("incomplete", "image-unavailable");
+                        const png = await checkpoint.target.screenshot({ type: "png", scale: "css", animations: "disabled", timeout });
+                        if (png.length > MAX_BYTES)
+                            throw new Outcome("failed", "image-too-large");
+                        if (await bounded(() => Promise.resolve(checkpoint.assertImage(Buffer.from(png))), timeout) !== true)
+                            throw new Outcome("failed", "image-assertion");
+                        const artifact = join(dirname(output), `${checkpoint.id}.png`);
+                        await privateFile(artifact, png);
+                        observation = { imageSha256: digest(png), bytes: png.length };
+                        break;
+                    }
+                    case "server-observation": {
+                        const calls = await bounded((signal) => checkpoint.collect({ runId: journey.runId, afterSequence: sequence, since, signal }), timeout);
+                        if (!Array.isArray(calls) || calls.length !== checkpoint.expectedCalls.length)
+                            throw new Outcome("incomplete", "server-observation-missing");
+                        const retained = calls.map((call, index) => {
+                            const expected = checkpoint.expectedCalls[index];
+                            if (call.nativeClient === "unverified")
+                                throw new Outcome("incomplete", "native-client-unverified");
+                            const observed = Date.parse(call.observedAt);
+                            if (call.nativeClient !== "verified-chatgpt" || !Number.isFinite(observed) || observed < Date.parse(since) - clockSkewMs || observed > Date.now() + clockSkewMs || call.runId !== journey.runId || call.endpointSha256 !== endpointSha256 || !Number.isSafeInteger(call.sequence) || call.sequence <= sequence)
+                                throw new Outcome("failed", "server-observation-scope");
+                            if (call.method !== expected.method || call.target !== expected.target || call.outcome !== expected.outcome || !SHA256.test(call.requestSha256) || !SHA256.test(call.responseSha256) || (expected.responseSha256 !== undefined && call.responseSha256 !== expected.responseSha256))
+                                throw new Outcome("failed", "server-assertion");
+                            sequence = call.sequence;
+                            return { method: call.method, targetSha256: digest(call.target), requestSha256: call.requestSha256, responseSha256: call.responseSha256, outcome: call.outcome };
+                        });
+                        observedCalls += calls.length;
+                        pendingObservation = false;
+                        observation = { calls: retained, contractSha256: digest(JSON.stringify(checkpoint.expectedCalls)) };
+                        break;
+                    }
+                    case "application-state": {
+                        const state = await bounded(checkpoint.readState, timeout);
+                        if (state !== checkpoint.expectedSha256)
+                            throw new Outcome("failed", "application-state-assertion");
+                        observation = { stateSha256: state };
+                        break;
+                    }
+                }
+                assertNativeHost(journey.page);
+                checkpoints.push(Object.freeze({ id: checkpoint.id, operation: checkpoint.operation, status: "passed", category: "verified", ...(observation ? { observation } : {}) }));
+            }
+            catch (error) {
+                const outcome = error instanceof Outcome ? error : new Outcome("incomplete", "browser-or-observer-unavailable");
+                checkpoints.push(Object.freeze({ id: checkpoint.id, operation: checkpoint.operation, status: outcome.status, category: outcome.category }));
+                break;
+            }
+        }
+        if (checkpoints.every((checkpoint) => checkpoint.status === "passed") && (pendingObservation || observedCalls === 0 || sentTurns === 0)) {
+            checkpoints.push(Object.freeze({ id: "server-evidence", operation: "server-observation", status: "incomplete", category: "unobserved-turn" }));
+        }
+    }
+    finally {
+        try {
+            const result = await bounded(journey.cleanup, timeout);
+            const confirmed = result?.fixturesRemoved === true && result?.conversationsRemoved === true;
+            checkpoints.push(Object.freeze({ id: "cleanup", operation: "cleanup", status: confirmed ? "passed" : "incomplete", category: confirmed ? "verified" : "cleanup-unconfirmed" }));
+        }
+        catch {
+            checkpoints.push(Object.freeze({ id: "cleanup", operation: "cleanup", status: "incomplete", category: "cleanup-unconfirmed" }));
+        }
+    }
+    const status = ["failed", "blocked", "incomplete"].find((candidate) => checkpoints.some((checkpoint) => checkpoint.status === candidate)) ?? "passed";
+    const evidence = Object.freeze({
+        schemaVersion: 1, evidenceKind: "native-chatgpt-browser", status, runId: journey.runId, endpointSha256,
+        ownershipSha256, clockSkewMs,
+        startedAt, finishedAt: new Date().toISOString(), checkpoints: Object.freeze(checkpoints),
+    });
+    await privateFile(output, `${JSON.stringify(evidence, null, 2)}\n`);
+    return evidence;
+}
+class Outcome extends Error {
+    status;
+    category;
+    constructor(status, category) {
+        super(category);
+        this.status = status;
+        this.category = category;
+    }
+}
+function assertNativeHost(page) {
+    try {
+        if (new URL(page.url()).origin === "https://chatgpt.com")
+            return;
+    }
+    catch { /* No native host is observable. */ }
+    throw new Outcome("blocked", "native-host-required");
+}
+function conversationId(url) { return new URL(url).pathname.match(/\/c\/([A-Za-z0-9-]+)(?:\/|$)/)?.[1]; }
+async function completedReply(reply, generating, timeout) {
+    const end = Date.now() + timeout;
+    let previous = "";
+    let stableSince = Date.now();
+    while (Date.now() < end) {
+        const text = await reply.innerText({ timeout: Math.max(1, end - Date.now()) });
+        if (Buffer.byteLength(text) > MAX_TEXT)
+            throw new Outcome("incomplete", "response-too-large");
+        if (text !== previous) {
+            previous = text;
+            stableSince = Date.now();
+        }
+        if (text.trim() && !(await generating.isVisible()) && Date.now() - stableSince >= 1_000)
+            return text;
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    throw new Outcome("incomplete", "response-not-complete");
+}
+async function bounded(operation, timeout) {
+    const controller = new AbortController();
+    let timer;
+    const expired = new Promise((_, reject) => { timer = setTimeout(() => { controller.abort(); reject(new Outcome("incomplete", "observation-timeout")); }, timeout); });
+    try {
+        return await Promise.race([Promise.resolve().then(() => operation(controller.signal)), expired]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function privateFile(path, data) {
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporary, data, { mode: 0o600, flag: "wx" });
+        await rename(temporary, path);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+}
+function validate(journey, output) {
+    if (journey.enabled !== true)
+        throw new TypeError("native ChatGPT browser testing must be explicitly enabled");
+    const auth = journey.authorization;
+    if (auth?.approved !== true || auth.fixturePolicy !== "synthetic" || [auth.accountOwner, auth.endpointOwner, auth.fixtureOwner, auth.cleanupOwner].some((owner) => typeof owner !== "string" || !owner.trim() || owner.length > 256))
+        throw new TypeError("approved account, endpoint, fixture, and cleanup ownership is required");
+    if (!(auth.endpoint instanceof URL) || auth.endpoint.protocol !== "https:" || auth.endpoint.username || auth.endpoint.password || auth.endpoint.search || auth.endpoint.hash)
+        throw new TypeError("an authorized HTTPS MCP endpoint without credentials is required");
+    if (!ID.test(journey.runId) || typeof output !== "string" || !output || typeof journey.cleanup !== "function" || !journey.page || !Array.isArray(journey.checkpoints) || journey.checkpoints.length === 0 || journey.checkpoints.length > 64)
+        throw new TypeError("a bounded native journey, private output, and cleanup are required");
+    if (journey.timeoutMs !== undefined && (!Number.isSafeInteger(journey.timeoutMs) || journey.timeoutMs < 100 || journey.timeoutMs > 300_000))
+        throw new TypeError("native journey timeout must be between 100 and 300000 milliseconds");
+    if (journey.clockSkewMs !== undefined && (!Number.isSafeInteger(journey.clockSkewMs) || journey.clockSkewMs < 0 || journey.clockSkewMs > 5_000))
+        throw new TypeError("native observation clock skew must be between 0 and 5000 milliseconds");
+    const ids = new Set(["cleanup", "server-evidence"]);
+    for (const checkpoint of journey.checkpoints) {
+        if (!ID.test(checkpoint.id) || ids.has(checkpoint.id))
+            throw new TypeError("checkpoint IDs must be unique bounded identifiers");
+        ids.add(checkpoint.id);
+        if (checkpoint.operation === "click" || checkpoint.operation === "visible" || checkpoint.operation === "image")
+            requireOwnedLocator(checkpoint.target, journey.page);
+        if (checkpoint.operation === "attach")
+            requireOwnedLocator(checkpoint.ready, journey.page);
+        if (checkpoint.operation === "attach" && (typeof checkpoint.file !== "string" || !checkpoint.file || typeof checkpoint.mimeType !== "string" || !/^[a-zA-Z0-9.+-]+\/[a-zA-Z0-9.+-]+$/.test(checkpoint.mimeType)))
+            throw new TypeError("a fixture file and MIME type are required");
+        if (checkpoint.operation === "send" && (typeof checkpoint.prompt !== "string" || !checkpoint.prompt.trim() || Buffer.byteLength(checkpoint.prompt) > MAX_TEXT || typeof checkpoint.expectResponse !== "function"))
+            throw new TypeError("a bounded prompt and response assertion are required");
+        if (checkpoint.operation === "human" && typeof checkpoint.ready !== "function")
+            throw new TypeError("human readiness observation is required");
+        if (checkpoint.operation === "image" && typeof checkpoint.assertImage !== "function")
+            throw new TypeError("an image assertion is required");
+        if (checkpoint.operation === "application-state" && (!SHA256.test(checkpoint.expectedSha256) || typeof checkpoint.readState !== "function"))
+            throw new TypeError("declared application state and an independent reader are required");
+        if (checkpoint.operation === "server-observation") {
+            if (typeof checkpoint.collect !== "function" || !Array.isArray(checkpoint.expectedCalls) || !checkpoint.expectedCalls.length || checkpoint.expectedCalls.length > 64)
+                throw new TypeError("bounded server observations and declared expectations are required");
+            for (const call of checkpoint.expectedCalls)
+                if (!METHODS.has(call.method) || typeof call.target !== "string" || call.target.length > 4096 || !["success", "denied", "cancelled"].includes(call.outcome) || (call.responseSha256 !== undefined && !SHA256.test(call.responseSha256)))
+                    throw new TypeError("invalid server observation expectation");
+        }
+        if (!["human", "fresh-conversation", "click", "attach", "send", "visible", "image", "application-state", "server-observation"].includes(checkpoint.operation))
+            throw new TypeError("unknown native checkpoint operation");
+    }
+}
+function requireOwnedLocator(locator, page) {
+    if (!locator || typeof locator.page !== "function" || locator.page() !== page)
+        throw new TypeError("native controls must belong to the authorized page");
+}
+//# sourceMappingURL=chatgpt.js.map

package/dist/chatgpt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatgpt.js","sourceRoot":"","sources":["../src/chatgpt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA+GpD,MAAM,EAAE,GAAG,mCAAmC,CAAC;AAC/C,MAAM,MAAM,GAAG,gBAAgB,CAAC;AAChC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAsB,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,yBAAyB,CAAC,CAAC,CAAC;AACnN,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACnC,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC;AAC3B,MAAM,MAAM,GAAG,CAAC,KAAsB,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAE5F,uFAAuF;AACvF,MAAM,UAAU,qBAAqB,CAAC,IAAU;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC;QAC1C,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC;QACvC,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,wCAAwC,CAAC;QACzE,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,2EAA2E,CAAC;QAC/G,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC;QAC3C,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,8BAA8B,CAAC;KACxD,CAAC,CAAC;AACL,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,0BAA0B,CAAC,OAA6B;IACtE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAA6B,EAAE,MAAc;IACzF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC5C,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAClM,8EAA8E;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,KAAK,oBAAoB;QACjG,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;QAC1N,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC;IACjD,MAAM,WAAW,GAAsC,EAAE,CAAC;IAC1D,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAI,iBAAqC,CAAC;IAC1C,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,KAAK,GAAG,SAAS,CAAC;IACtB,IAAI,CAAC;QACH,KAAK,MAAM,UAAU,IAAI,KAAK,EAAE,CAAC;YAC/B,IAAI,WAAgD,CAAC;YACrD,IAAI,CAAC;gBACH,IAAI,UAAU,CAAC,SAAS,KAAK,OAAO;oBAAE,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrE,QAAQ,UAAU,CAAC,SAAS,EAAE,CAAC;oBAC7B,KAAK,OAAO;wBACV,IAAI,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI;4BAAE,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;wBACtG,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;wBAC/B,MAAM;oBACR,KAAK,oBAAoB;wBACvB,IAAI,kBAAkB;4BAAE,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;wBAC3E,iBAAiB,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,iBAAiB,CAAC;wBAC5E,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,CAAC;wBAC5F,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;wBAC/D,IAAI,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;4BAAE,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;wBACxG,IAAI,MAAM,QAAQ,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC;4BAAE,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,gCAAgC,CAAC,CAAC;wBACzH,aAAa,GAAG,iBAAiB,KAAK,SAAS,CAAC;wBAChD,MAAM;oBACR,KAAK,OAAO;wBACV,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;wBACjC,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;wBAC3C,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;wBAC/B,MAAM;oBACR,KAAK,QAAQ,CAAC,CAAC,CAAC;wBACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;wBACzC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,SAAS;4BAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;wBAC9F,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;wBAC9C,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS;4BAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;wBAC/E,MAAM,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;wBACvI,MAAM,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;wBAC9D,WAAW,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;wBACjE,MAAM;oBACR,CAAC;oBACD,KAAK,MAAM,CAAC,CAAC,CAAC;wBACZ,IAAI,kBAAkB;4BAAE,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;wBAC3E,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;wBACxD,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;wBACjC,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;wBAC7D,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;wBACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;wBACrD,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;wBACnD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;wBACvE,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;wBAC/B,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;wBACxD,IAAI,CAAC,YAAY,IAAI,CAAC,aAAa,IAAI,YAAY,KAAK,iBAAiB,CAAC;4BAAE,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,gCAAgC,CAAC,CAAC;wBAC9I,IAAI,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI;4BAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;wBAC/I,iBAAiB,GAAG,YAAY,CAAC;wBACjC,aAAa,GAAG,KAAK,CAAC;wBACtB,kBAAkB,GAAG,IAAI,CAAC;wBAC1B,SAAS,IAAI,CAAC,CAAC;wBACf,WAAW,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;wBAClI,MAAM;oBACR,CAAC;oBACD,KAAK,SAAS;wBACZ,MAAM,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;wBAC/D,MAAM;oBACR,KAAK,OAAO,CAAC,CAAC,CAAC;wBACb,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;wBAClD,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,GAAG,SAAS;4BAAE,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;wBACrG,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;wBAC/G,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS;4BAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;wBAC3E,IAAI,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI;4BAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;wBACrJ,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;wBAC/D,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;wBACjC,WAAW,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;wBAC9D,MAAM;oBACR,CAAC;oBACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;wBAC1B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;wBACvI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,aAAa,CAAC,MAAM;4BAAE,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;wBAC7I,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;4BACzC,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,CAAC,KAAK,CAAE,CAAC;4BAClD,IAAI,IAAI,CAAC,YAAY,KAAK,YAAY;gCAAE,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;4BACpG,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;4BAC7C,IAAI,IAAI,CAAC,YAAY,KAAK,kBAAkB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,WAAW,IAAI,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,cAAc,KAAK,cAAc,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ;gCAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC;4BACxW,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC,cAAc,KAAK,QAAQ,CAAC,cAAc,CAAC;gCAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;4BACpU,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;4BACzB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;wBACnK,CAAC,CAAC,CAAC;wBACH,aAAa,IAAI,KAAK,CAAC,MAAM,CAAC;wBAC9B,kBAAkB,GAAG,KAAK,CAAC;wBAC3B,WAAW,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;wBACpG,MAAM;oBACR,CAAC;oBACD,KAAK,mBAAmB,CAAC,CAAC,CAAC;wBACzB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;wBAC3D,IAAI,KAAK,KAAK,UAAU,CAAC,cAAc;4BAAE,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,6BAA6B,CAAC,CAAC;wBACpG,WAAW,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;wBACrC,MAAM;oBACR,CAAC;gBACH,CAAC;gBACD,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC/B,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3K,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,YAAY,EAAE,iCAAiC,CAAC,CAAC;gBAChH,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;gBAC5I,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,kBAAkB,IAAI,aAAa,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;YACxI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,iBAAiB,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;QACjJ,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,MAAM,EAAE,eAAe,KAAK,IAAI,IAAI,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;YAC5F,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;QAClL,CAAC;QAAC,MAAM,CAAC;YACP,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC;QAClI,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAW,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,IAAI,QAAQ,CAAC;IACjK,MAAM,QAAQ,GAA0B,MAAM,CAAC,MAAM,CAAC;QACpD,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,cAAc;QACtG,eAAe,EAAE,WAAW;QAC5B,SAAS,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;KACzF,CAAC,CAAC;IACH,MAAM,WAAW,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACpE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,OAAQ,SAAQ,KAAK;IACJ;IAAsC;IAA3D,YAAqB,MAA2B,EAAW,QAAgB;QAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;QAA1E,WAAM,GAAN,MAAM,CAAqB;QAAW,aAAQ,GAAR,QAAQ,CAAQ;IAAqB,CAAC;CAClG;AAED,SAAS,gBAAgB,CAAC,IAAU;IAClC,IAAI,CAAC;QAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,KAAK,qBAAqB;YAAE,OAAO;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,mCAAmC,CAAC,CAAC;IACvH,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,cAAc,CAAC,GAAW,IAAwB,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAErI,KAAK,UAAU,cAAc,CAAC,KAAc,EAAE,UAAmB,EAAE,OAAe;IAChF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;IACjC,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/E,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ;YAAE,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;QAC9F,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAAC,QAAQ,GAAG,IAAI,CAAC;YAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAAC,CAAC;QACrE,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,SAAS,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,IAAI,KAAK;YAAE,OAAO,IAAI,CAAC;QACrG,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,OAAO,CAAI,SAA8C,EAAE,OAAe;IACvF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,KAAoC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7K,IAAI,CAAC;QAAC,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,CAAC;YACjG,CAAC;QAAC,YAAY,CAAC,KAAM,CAAC,CAAC;IAAC,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,IAAqB;IAC5D,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;YAAS,CAAC;QAAC,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAAC,CAAC;AACrD,CAAC;AAED,SAAS,QAAQ,CAAC,OAA6B,EAAE,MAAc;IAC7D,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,2DAA2D,CAAC,CAAC;IAC/G,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IACnC,IAAI,IAAI,EAAE,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,aAAa,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,wEAAwE,CAAC,CAAC;IACpU,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,YAAY,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,kEAAkE,CAAC,CAAC;IACtQ,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,oEAAoE,CAAC,CAAC;IACxU,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAS,GAAG,GAAG,IAAI,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,oEAAoE,CAAC,CAAC;IACvO,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,uEAAuE,CAAC,CAAC;IAC9O,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACpD,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;QAChI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACvB,IAAI,UAAU,CAAC,SAAS,KAAK,OAAO,IAAI,UAAU,CAAC,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,SAAS,KAAK,OAAO;YAAE,mBAAmB,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACrK,IAAI,UAAU,CAAC,SAAS,KAAK,QAAQ;YAAE,mBAAmB,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3F,IAAI,UAAU,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,UAAU,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;QACnR,IAAI,UAAU,CAAC,SAAS,KAAK,MAAM,IAAI,CAAC,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,QAAQ,IAAI,OAAO,UAAU,CAAC,cAAc,KAAK,UAAU,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;QAC/R,IAAI,UAAU,CAAC,SAAS,KAAK,OAAO,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;QAC/I,IAAI,UAAU,CAAC,SAAS,KAAK,OAAO,IAAI,OAAO,UAAU,CAAC,WAAW,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;QAC5I,IAAI,UAAU,CAAC,SAAS,KAAK,mBAAmB,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,OAAO,UAAU,CAAC,SAAS,KAAK,UAAU,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,mEAAmE,CAAC,CAAC;QACtO,IAAI,UAAU,CAAC,SAAS,KAAK,oBAAoB,EAAE,CAAC;YAClD,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,MAAM,IAAI,UAAU,CAAC,aAAa,CAAC,MAAM,GAAG,EAAE;gBAAE,MAAM,IAAI,SAAS,CAAC,oEAAoE,CAAC,CAAC;YAChQ,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,aAAa;gBAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;oBAAE,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;QACtV,CAAC;QACD,IAAI,CAAC,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAC5N,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAgB,EAAE,IAAU;IACvD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;AAC3J,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emseepea/testing",
-  "version": "0.23.5",
+  "version": "0.24.0",
   "description": "MCP integration and semantic testing helpers",
   "license": "MIT",
   "repository": {
@@ -27,12 +27,18 @@
     "./semantic": {
       "types": "./semantic/test.d.mts",
       "import": "./semantic/test.mjs"
+    },
+    "./chatgpt": {
+      "types": "./dist/chatgpt.d.ts",
+      "import": "./dist/chatgpt.js"
     }
   },
   "bin": {
     "emseepea-contract": "./published-contract/cli.mjs",
     "emseepea-qualify": "./mcp-cli/cli.mjs",
-    "emseepea-test": "./semantic/cli.mjs"
+    "emseepea-test": "./semantic/cli.mjs",
+    "emseepea-chatgpt-setup": "./chatgpt/setup.mjs",
+    "emseepea-chatgpt": "./chatgpt/run.mjs"
   },
   "files": [
     "dist",
@@ -40,7 +46,8 @@
     "published-contract",
     "semantic",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "chatgpt"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json && tsc -p tsconfig.type-tests.json",

package/semantic/provider.mjs

@@ -6,7 +6,6 @@ import { scriptedElicitations } from "./elicitation.mjs";
 
 const claudeModel = "claude-sonnet-4-6";
 const mcpServerName = "emseepea_eval";
-const minimumCodexCliVersion = "0.162.0";
 const codexEmptyDiscoveryTools = new Map([
   ["list_mcp_resources", "resources"],
   ["list_mcp_resource_templates", "resourceTemplates"],
@@ -44,9 +43,6 @@ export async function modelVersion(provider = "claude-local") {
   const result = await runProcess(command, ["--version"], { env: modelEnvironment({}) });
   const version = result.stdout.trim().match(/(?:codex-cli\s+)?(\d+\.\d+\.\d+)\b/)?.[1];
   if (result.code !== 0 || !version) throw new Error(`Could not verify ${codex ? "Codex" : "Claude"} CLI version`);
-  if (codex && compareVersions(version, minimumCodexCliVersion) < 0) {
-    throw new Error(`Codex CLI ${version} is unsupported; use ${minimumCodexCliVersion} or later`);
-  }
   return version;
 }
 
@@ -677,16 +673,6 @@ function classifyCodexFailure(stderr) {
   return "unknown";
 }
 
-function compareVersions(left, right) {
-  const a = left.split(".").map(Number);
-  const b = right.split(".").map(Number);
-  for (let index = 0; index < Math.max(a.length, b.length); index += 1) {
-    const difference = (a[index] ?? 0) - (b[index] ?? 0);
-    if (difference !== 0) return difference;
-  }
-  return 0;
-}
-
 function codexEvidenceError(message, category) {
   return Object.assign(new Error(message), {
     providerFailureCategory: codexFailureCategories.has(category) ? category : "unknown",