@markusylisiurunen/tau 0.3.80 → 0.3.82

package/dist/core/code_mode/models.js

@@ -0,0 +1,256 @@
+import { z } from "zod";
+import { openRouterModels, requestOpenRouterChat, requestOpenRouterDecisions, } from "../models/openrouter.js";
+const kind = z.enum(["image", "audio", "video"]);
+const attachment = z.union([
+    z.strictObject({ type: kind, path: z.string().min(1) }),
+    z.strictObject({ type: kind, data: z.string().min(1), mimeType: z.string().min(1) }),
+]);
+const chatOptions = z.strictObject({
+    model: z.string().min(1),
+    prompt: z.string().min(1),
+    system: z.string().min(1).optional(),
+    reasoning: z.string().optional(),
+    attachments: z.array(attachment).max(16).default([]),
+});
+const decisionOptions = z.strictObject({
+    model: z.string().min(1),
+    state: z.unknown(),
+    questions: z.unknown(),
+});
+export function createModelsCapability(backend, config, fetchImpl) {
+    return {
+        name: "models",
+        description: "Call AI models through OpenRouter for focused, standalone tasks. Example uses include extraction and summarization, image/audio/video analysis, typed classification or scoring, and second opinions. Each call uses only explicitly supplied inputs, without conversation context or agent tools.",
+        documentation: `# tau.models
+
+Use AI models for focused tasks with explicitly supplied inputs. Calls do not inherit the conversation, persona, tools, or an implicit system prompt. Use chat for text/media understanding and free-form answers; use decisions for named classification, probability, or scoring questions.
+
+## Interface
+
+\`\`\`ts
+type ModelsApi = {
+  list(): Promise<ModelList>;
+  chat(options: ChatOptions): Promise<ChatResult>;
+  decisions(options: DecisionOptions): Promise<DecisionResult>;
+};
+\`\`\`
+
+## \`tau.models.list()\`
+
+Takes no arguments and returns the fixed model catalog:
+
+\`\`\`ts
+type Model = {
+  id: string;
+  inputs: string[];
+  reasoning: string[];
+  role: string;
+};
+type ModelList = { chat: Model[]; decisions: Model[] };
+\`\`\`
+
+Listing makes no provider request and requires no credentials. Select an exact ID from the appropriate list using its input modalities and role guidance. Only listed models and reasoning efforts are accepted. There is no default model, automatic substitution, or live discovery. Reuse a catalog already visible in the conversation.
+
+## \`tau.models.chat(options)\`
+
+Send one nonstreaming request.
+
+\`\`\`ts
+type Attachment = { type: "image" | "audio" | "video" } & (
+  | { path: string; data?: never; mimeType?: never }
+  | { data: string; mimeType: string; path?: never }
+);
+type ChatOptions = {
+  model: string;
+  prompt: string;
+  system?: string;
+  reasoning?: string;
+  attachments?: Attachment[];
+};
+type ChatResult = {
+  requested_model: string;
+  model: string;
+  answer: string | null;
+  finish_reason: "stop" | "length" | "content_filter";
+  id?: string;
+  provider?: string;
+  refusal?: string | null;
+  native_finish_reason?: string | null;
+  usage?: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+    cost?: number | null;
+    [key: string]: unknown;
+  };
+};
+\`\`\`
+
+\`prompt\` and optional \`system\` must be nonblank. Omitted attachments default to an empty array. Omitted system instructions send no system message. Omitted reasoning leaves that setting to the provider; it does not necessarily disable reasoning. Reasoning traces are not returned as answer text.
+
+Attachments follow the prompt in array order. Paths resolve from the current working directory. Inline data must be canonical padded base64 with a MIME type matching the actual bytes. Supply exactly one source form per attachment, not a URL. Audio/video require ffprobe on PATH. Unsupported media fail rather than being resized, converted, transcribed, or split automatically.
+
+\`requested_model\` records the selected ID; \`model\` records the provider's returned ID. Inspect completion status before using the answer:
+
+- \`stop\` with no refusal is complete.
+- \`length\` is incomplete, even if answer text is empty.
+- \`content_filter\` or a nonempty \`refusal\` is refusal, not a completed answer.
+
+These statuses resolve normally. Invalid responses, unexpected tool calls, and a normal stop with neither answer nor refusal throw. No output token cap is sent; provider and model limits still apply.
+
+For example, select a listed image-capable model and supply an existing screenshot:
+
+\`\`\`js
+const catalog = await tau.models.list();
+const model = catalog.chat.find(item => item.id === "openai/gpt-6-luna");
+if (!model || !model.inputs.includes("image")) throw new Error("model unavailable for images");
+const result = await tau.models.chat({
+  model: model.id,
+  prompt: "Extract the error message and describe the visible failure.",
+  attachments: [{ type: "image", path: "./screenshot.png" }],
+});
+if (result.finish_reason !== "stop" || result.refusal || !result.answer)
+  throw new Error("model did not produce a complete answer");
+printText(result.answer);
+\`\`\`
+
+## \`tau.models.decisions(options)\`
+
+Ask several named questions about one supplied state. Independent questions can share a request; dependent questions require separate calls.
+
+\`\`\`ts
+type Json = null | boolean | number | string | Json[] | { [key: string]: Json };
+type Guidance = string | Json[] | { [key: string]: Json };
+type Question =
+  | { type: "noul"; instructions: Guidance; criteria?: { true: Guidance; false: Guidance } }
+  | { type: "choice"; instructions: Guidance; criteria: Record<string, Guidance | null> }
+  | { type: "score"; instructions: Guidance; criteria: Guidance[] };
+type DecisionOptions = {
+  model: string;
+  state: Guidance;
+  questions: Record<string, Question>;
+};
+type Answer =
+  | { type: "noul"; noul: number }
+  | {
+      type: "choice";
+      choice: string;
+      confidence?: number;
+      probabilities?: Record<string, number>;
+    }
+  | {
+      type: "score";
+      score: number;
+      confidence?: number;
+      probabilities?: Record<string, number>;
+      legend?: Record<string, Guidance>;
+    };
+type DecisionResult = {
+  requested_model: string;
+  model: string;
+  answers: Record<string, Answer>;
+  usage: { input_tokens: number; output_tokens: number; cost?: number; [key: string]: unknown };
+  id?: string;
+  provider?: string;
+};
+\`\`\`
+
+\`questions\` must be nonempty with nonempty names. Choice criteria require at least one category; score criteria require a nonempty ordered rubric. Unknown question fields and the question/category name \`__proto__\` are rejected. Every question receives an answer of the corresponding type:
+
+- \`noul\`: probability from 0 to 1, not a boolean.
+- \`choice\`: one supplied category; optional confidence and category probabilities are from 0 to 1.
+- \`score\`: position from 0 to the final rubric index, possibly fractional. Distribution and legend keys are rubric-index strings. Optional confidence and probabilities are from 0 to 1.
+
+Negative judgments and low confidence are normal results. Responses with mismatched names, types, categories, or ranges throw; no decision thresholds or prose explanations are invented.
+
+\`\`\`js
+const catalog = await tau.models.list();
+const model = catalog.decisions.find(item => item.id === "typesafe/jev-1.13");
+if (!model) throw new Error("decision model unavailable");
+const result = await tau.models.decisions({
+  model: model.id,
+  state: { ticket: "Checkout crashes when I click Pay." },
+  questions: {
+    is_bug: { type: "noul", instructions: "Does this describe broken behavior?" },
+    urgency: {
+      type: "score",
+      instructions: "How urgent is this issue?",
+      criteria: ["Can wait", "Fix soon", "Blocking revenue"],
+    },
+  },
+});
+printText(JSON.stringify(result.answers));
+\`\`\`
+
+## Limits and failures
+
+Byte limits below use decimal bytes:
+
+- Each prompt/system input and the decisions input: 1,000,000 UTF-8 bytes.
+- Attachments: 16 total, including at most 4 audio and 1 video.
+- Each image: 5,000,000 bytes; PNG/JPEG/WebP, one frame, at most 8,000 pixels per edge and 32 megapixels.
+- Each audio/video: 12,000,000 bytes; single-stream PCM16 WAV or MP3, or H.264 MP4 up to 3840×2160 with optional AAC. Positive known duration, at most 600 seconds combined.
+- Encoded request: 20,000,000 bytes including base64 and text; response: 8,000,000 bytes.
+
+Validation, authentication, service failures, and malformed responses throw. There are no automatic retries. A failed or interrupted request may already be billable: inspect the outcome before retrying. Returned usage contains provider-reported metadata, not estimates; external charges are not included in session cost or usage logs.`,
+        api: {
+            list: (args) => {
+                z.tuple([]).parse(args);
+                return structuredClone(openRouterModels);
+            },
+            chat: async (args, context) => {
+                const [input] = z.tuple([chatOptions]).parse(args);
+                return await requestOpenRouterChat({
+                    ...input,
+                    attachments: input.attachments.map(({ type, ...source }) => ({
+                        kind: type,
+                        ...source,
+                    })),
+                }, {
+                    config,
+                    signal: context.signal,
+                    fetchImpl,
+                    mediaAdapter: {
+                        readFile: async (path, limit) => {
+                            context.signal.throwIfAborted();
+                            const file = await backend.readFileBinary(path, { maxBytes: limit });
+                            context.signal.throwIfAborted();
+                            return file.content;
+                        },
+                        probe: async (bytes, format) => {
+                            const result = await backend.runNodeScript(probeScript, [], {
+                                signal: context.signal,
+                                timeoutMs: 20_000,
+                                maxCaptureBytes: 1_000_000,
+                                stdin: Buffer.from(JSON.stringify({ data: bytes.toString("base64"), format })),
+                            });
+                            if (result.exitCode !== 0 || result.truncated || result.timedOut || result.aborted)
+                                throw new Error("failed to validate media; ensure ffprobe is installed and the media is valid");
+                            return JSON.parse(result.stdout);
+                        },
+                    },
+                });
+            },
+            decisions: async (args, context) => {
+                const [input] = z.tuple([decisionOptions]).parse(args);
+                return await requestOpenRouterDecisions(input.model, { state: input.state, questions: input.questions }, { config, signal: context.signal, fetchImpl });
+            },
+        },
+    };
+}
+const probeScript = `
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { execFileSync } = require("node:child_process");
+const input = JSON.parse(fs.readFileSync(0, "utf8"));
+const directory = fs.mkdtempSync(path.join(os.tmpdir(), "tau-model-media-"));
+try {
+  const file = path.join(directory, "input");
+  fs.writeFileSync(file, Buffer.from(input.data, "base64"), { mode: 0o600 });
+  process.stdout.write(execFileSync("ffprobe", ["-v", "error", "-protocol_whitelist", "file", "-f", input.format, "-show_entries", "format=duration:stream=codec_type,codec_name,width,height", "-of", "json", file], { timeout: 15000, maxBuffer: 1000000 }));
+} finally {
+  fs.rmSync(directory, { recursive: true, force: true });
+}
+`;
+//# sourceMappingURL=models.js.map

package/dist/core/code_mode/models.js.map

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

package/dist/core/{tools → code_mode}/nook.js

@@ -1,40 +1,15 @@
 import { readFileSync } from "node:fs";
-import { Type } from "typebox";
 import { z } from "zod";
 import { createNookClientFromConfig } from "../nook/client.js";
 import { buildNookDeployManifestFromBackend, buildNookTemplateManifestFromBackend, } from "../nook/deploy.js";
 import { validateNookSiteSlug, validateNookTemplateName } from "../nook/validation.js";
 import { formatZodError } from "../utils/zod.js";
-import { buildCodeModeToolDescription, createCodeModeToolDefinition, executeInternalCodeMode, } from "./code_mode.js";
-import { TOOL_NAME_NOOK } from "./tool_names.js";
-const NOOK_CODE_MODE_TIMEOUT_MS = 60_000;
 const MAX_KV_KEY_LENGTH = 256;
 const MAX_KV_VALUE_BYTES = 64 * 1024;
-const NOOK_DESCRIPTION = buildCodeModeToolDescription({
-    sdkGlobal: "nook",
-    introduction: [
-        "Run a one-shot JavaScript program to operate the configured Nook platform: Tau's Cloudflare-backed static mini-app host for publishing built front-end artifacts with optional per-site same-origin JSON KV.",
-        "Do not use this tool autonomously; use it only when the user asks to manage Nook, deploy/publish/host an app or artifact, inspect Nook state, or manage Nook KV.",
-        "If the user asks to deploy a static artifact or mini-app, this is usually the right deployment target.",
-    ],
-    additionalDocumentation: [
-        "When app-authoring guidance is needed, treat nook.skill() as a second documentation step: after reading docs, run a separate documentation-only call that does nothing except console.log(await nook.skill()). Read the returned guide before authoring or modifying the app in later calls.",
-    ],
-});
-export const NOOK_TOOL = {
-    name: TOOL_NAME_NOOK,
-    description: NOOK_DESCRIPTION,
-    parameters: Type.Object({
-        code: Type.String({
-            description: "JavaScript source to execute. Use console output for text and await image(block) to return images.",
-        }),
-    }, { additionalProperties: false }),
-};
-const nookArgsSchema = z
-    .object({
-    code: z.string().trim().min(1, "must not be empty."),
-})
-    .strict();
+const description = [
+    "Publish static apps and artifacts, inspect hosted sites, and manage their JSON KV on Nook.",
+    "Use tau.nook only when the user asks for deployment, hosting, or Nook management. Nook is the usual target for static mini-app publishing.",
+].join(" ");
 const nonEmptyStringSchema = z.string().trim().min(1);
 const directorySchema = nonEmptyStringSchema;
 const fileSchema = nonEmptyStringSchema;
@@ -60,34 +35,10 @@ function validatedPathLabel(validate) {
 const siteSchema = validatedPathLabel(validateNookSiteSlug);
 const templateSchema = validatedPathLabel(validateNookTemplateName);
 const documentation = readFileSync(new URL("../static/code_mode/nook/documentation.md", import.meta.url), "utf8");
-function parseNookArguments(raw) {
-    const rawCode = typeof raw === "object" && raw !== null && typeof raw.code === "string"
-        ? raw.code
-        : "";
-    const subject = rawCode
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .find(Boolean) ?? "(invalid code)";
-    const parsed = nookArgsSchema.safeParse(raw);
-    if (!parsed.success) {
-        return {
-            ok: false,
-            error: formatZodError(parsed.error),
-            code: rawCode,
-            subject,
-        };
-    }
-    return {
-        ok: true,
-        args: parsed.data,
-        code: parsed.data.code,
-        subject,
-    };
-}
 function parseMethodArguments(method, args, schema) {
     const parsed = schema.safeParse(args);
     if (!parsed.success) {
-        throw new Error(`Invalid nook.${method} arguments: ${formatZodError(parsed.error)}`);
+        throw new Error(`Invalid tau.nook.${method} arguments: ${formatZodError(parsed.error)}`);
     }
     return parsed.data;
 }
@@ -142,7 +93,7 @@ async function writeKvToFile(client, backend, site, key, file, signal) {
     signal.throwIfAborted();
     const content = JSON.stringify(value);
     if (content === undefined) {
-        throw new Error(`nook.kv.getToFile received a non-JSON value for ${site}/${key}`);
+        throw new Error(`tau.nook.kv.getToFile received a non-JSON value for ${site}/${key}`);
     }
     const result = await backend.writeFile(file, content);
     signal.throwIfAborted();
@@ -238,10 +189,14 @@ async function handleNookRequest(method, args, deps, config, backend, signal) {
             throw new Error(`unsupported nook method '${method}'`);
     }
 }
-function executeNookProgram(code, deps, config, backend, agentId, signal, timeoutMs) {
+const defaultDeps = { createClient: createNookClientFromConfig };
+export function createNookCapability(backend, config, deps = defaultDeps) {
+    if (!config.nook)
+        throw new Error("nook is not configured");
     const method = (name) => async (args, context) => await handleNookRequest(name, args, deps, config, backend, context.signal);
-    return executeInternalCodeMode({
-        name: TOOL_NAME_NOOK,
+    return {
+        name: "nook",
+        description,
         documentation,
         api: {
             skill: method("skill"),
@@ -266,25 +221,6 @@ function executeNookProgram(code, deps, config, backend, agentId, signal, timeou
                 list: method("kv.list"),
             },
         },
-        code,
-        agentId,
-        backend,
-        signal,
-        timeoutMs,
-    });
-}
-const defaultDeps = {
-    createClient: createNookClientFromConfig,
-};
-export function createNookToolDefinition(backend, config, deps = defaultDeps) {
-    const timeoutMs = deps.timeoutMs ?? NOOK_CODE_MODE_TIMEOUT_MS;
-    const implementation = {
-        schema: NOOK_TOOL,
-        timeoutMs,
-        parseArguments: parseNookArguments,
-        getBlockedReason: () => (config.nook ? undefined : "nook is not configured"),
-        execute: async ({ code, agentId, signal, backend: executionBackend }) => executeNookProgram(code, deps, config, executionBackend, agentId, signal, timeoutMs),
     };
-    return createCodeModeToolDefinition(backend, implementation);
 }
 //# sourceMappingURL=nook.js.map

package/dist/core/code_mode/nook.js.map

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

package/dist/core/code_mode/sdk.js

@@ -0,0 +1,97 @@
+import { z } from "zod";
+export function bindCodeModeSdk(capabilities) {
+    const byName = new Map(capabilities.map((capability) => [capability.name, capability]));
+    if (byName.size !== capabilities.length || byName.has("docs"))
+        throw new Error("duplicate or reserved code-mode capability");
+    return {
+        documentation: [
+            "## Tau capabilities",
+            "",
+            ...capabilities.map(({ name, description }) => `- tau.${name}: ${description}`),
+            "",
+            'Before using a capability, read its documentation in a separate call: printText(await tau.docs("bash")). Reuse documentation already visible in the conversation. Do not guess signatures. tau.docs(name) accepts exactly one enabled capability name and returns its complete API reference.',
+            `
+## Composing programs
+
+Use a program when keeping intermediate data in JavaScript makes the task clearer: pass one call's result into another, combine independent evidence, or reduce a large response to the relevant facts. A single direct tool call is fine when composition adds nothing. Only enabled capabilities are callable, and their use restrictions still apply inside a program.
+
+Plan around dependencies. Await a result before using it; run independent calls concurrently only when every result is needed, with a small explicit bound below the runtime's concurrency limit. Use service filters and pagination to bound inputs before processing them. For paginated work, print continuation values and resume in another program before exhausting its call or output budget. Keep reusable logic in small functions and avoid elaborate frameworks for one-shot work.
+
+Check results before passing them onward: command exit and truncation fields, per-item retrieval errors, and model completion or refusal status can indicate failure even when the call itself resolves. Stop dependent work when required input is incomplete. For independent work, catch errors per item only when partial results are useful, and report what is missing rather than silently treating failures as empty data.
+
+Print a concise result with evidence, identifiers, and any limitations needed for the next decision. Intermediate values stay in the program unless printed. Side effects and external charges are not rolled back. After failure or interruption, inspect what completed and retry only the necessary work, not the whole program blindly.
+
+For web documentation research (requires web and Bash), search for the official site if needed, then discover its relevant page or root. Retrieve advertised Markdown or llms.txt and relevant Markdown pages with curl, using the Accept: text/markdown header for content negotiation. Do not pass these resources to tau.web.fetch. Prefer them over search highlights; use extraction for ordinary pages when no suitable representation exists or extraction is preferable.
+
+For app authoring (requires Nook and filesystem tools), read Nook's authoring guide first. Keep a new app's complete working tree in a fresh temporary directory, create or copy its sources, build with Bash, and deploy the built static output with explicit visibility. These steps can be composed after the relevant references have been read; Nook does not build source trees itself.
+
+### Examples for adaptation
+
+These illustrate possibilities, not required workflows. Use only capabilities available for the task, read their references first, and adapt inputs, model choices, and result checks to the actual request.
+
+Chain shell output into focused inference (requires Bash and models):
+
+\`\`\`js
+const run = await tau.bash.run({ command: "git diff --stat" });
+if (run.exitCode !== 0 || run.truncated || run.timedOut || run.aborted)
+  throw new Error("incomplete diff summary");
+const result = await tau.models.chat({
+  model: "openai/gpt-6-luna",
+  prompt: "Summarize this change footprint without inferring implementation details:\\n" + run.stdout,
+});
+if (result.finish_reason !== "stop" || result.refusal || !result.answer)
+  throw new Error("model did not produce a complete answer");
+printText(result.answer);
+\`\`\`
+
+Combine a bounded set of independent searches and deduplicate evidence (requires web and a task that calls for web search):
+
+\`\`\`js
+const queries = ["CSS nesting browser support", "CSS nesting known limitations"];
+const responses = await Promise.all(
+  queries.map(query => tau.web.search(query, { numResults: 3 })),
+);
+const unique = new Map();
+for (const response of responses) {
+  for (const status of response.statuses) {
+    if (status.status !== "success") printText("Retrieval failed: " + status.id);
+  }
+  for (const result of response.results) unique.set(result.url, result);
+}
+for (const result of unique.values()) printText(result.title + "\\n" + result.url);
+\`\`\`
+
+Keep useful independent results when one operation fails (requires Bash):
+
+\`\`\`js
+const commands = ["git status --short", "git diff --stat"];
+const results = await Promise.allSettled(
+  commands.map(command => tau.bash.run({ command })),
+);
+for (const [index, result] of results.entries()) {
+  printText(commands[index]);
+  if (result.status === "rejected") {
+    printText("Command unavailable: " + String(result.reason));
+  } else {
+    const run = result.value;
+    if (run.exitCode !== 0 || run.truncated || run.timedOut || run.aborted)
+      printText("Incomplete command result; do not treat it as full evidence.");
+    printText(truncateLines(run.output, { maxLines: 30 }));
+  }
+}
+\`\`\`
+`,
+        ].join("\n"),
+        api: {
+            ...Object.fromEntries(capabilities.map(({ name, api }) => [name, api])),
+            docs: (args) => {
+                const [name] = z.tuple([z.string().min(1)]).parse(args);
+                const capability = byName.get(name);
+                if (!capability)
+                    throw new Error(`unavailable code-mode capability '${name}'`);
+                return capability.documentation;
+            },
+        },
+    };
+}
+//# sourceMappingURL=sdk.js.map

package/dist/core/code_mode/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../../src/core/code_mode/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,eAAe,CAAC,YAAkC;IAIhE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACxF,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,OAAO;QACL,aAAa,EAAE;YACb,qBAAqB;YACrB,EAAE;YACF,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,SAAS,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/E,EAAE;YACF,+RAA+R;YAC/R;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEL;SACI,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,GAAG,EAAE;YACH,GAAG,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;YACvE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;gBACb,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACpC,IAAI,CAAC,UAAU;oBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,GAAG,CAAC,CAAC;gBAC/E,OAAO,UAAU,CAAC,aAAa,CAAC;YAClC,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}