@koda-sl/baker-bridge 0.125.0 → 0.127.0-dev.c97e2d09a

package/README.md

@@ -43,6 +43,7 @@ await server.start();
 | `INTERNAL_SECRET_KEY` | AES key for encrypting flow `_data.json` config at rest |
 | `ANTHROPIC_API_KEY` | Anthropic API key (required by the Agent SDK) |
 | `ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN` | OpenRouter routing (base URL + per-org key) injected into the sandbox. Forwarded to the Agent SDK subprocess so the agent can reach its model |
+| `OPENROUTER_API_KEY` | The same per-org key under its own name. The bridge reads the user's and the agent's words with it before letting two kinds of call through: a question asking the user to pick an avatar's face (the casting picker shows real portraits), and an avatar accent in a language nobody asked for. Unset or unreachable, both calls go through unchecked |
 | `CLAUDE_CODE_EXTRA_BODY` | Optional JSON merged by the CLI into every model request body. The bridge sets/extends it per turn with a per-thread `session_id` so OpenRouter sticky-routes the whole conversation to one provider instance and its instance-scoped prompt cache is re-read across the turn's many tool-call requests (see [Prompt-cache pinning](#prompt-cache-pinning)). It also defaults `provider` to Bedrock first (see [Bedrock is the preferred provider](#bedrock-is-the-preferred-provider)). Any inherited value is merged; our `session_id` and the `web`-plugin opt-out win (see [OpenRouter web plugin is forced off](#openrouter-web-plugin-is-forced-off)). An inherited `provider` replaces the Bedrock default |
 | `BAKER_CHAT_ID` | Present only when running inside a chat sandbox. When set, the bridge relocates Claude Code auto-memory into the cloned repo (`.claude/memory`) — see [Session journal](#session-journal-agent-memory) |
 | `BAKER_ACTING_USER_ID` | Injected into the Agent SDK subprocess env per turn (when the turn's sender is known) so in-sandbox `baker` CLI calls can scope work to the acting user — e.g. `baker mcp add --scope user` |

package/dist/hono/avatar-accent.d.ts

@@ -13,11 +13,29 @@
  * own description, in the creation hint and in the family doc by now, so this is the
  * layer left.
  *
- * Narrow by construction — it only fires when the user is clearly writing Spanish AND
- * the accent clearly names another language AND nothing the user said asks for that
- * language or market. An ad a Spaniard genuinely wants in English says so, and then
- * this stays out of the way.
+ * Whether the accent fits is read by Jev from what the user said, in whatever language
+ * they write, and from the company's own Knowledge (COMPANY.md): their own language, the
+ * language the company's content is written in, a regional accent of either, or a language
+ * or market they asked for all fit. An agency member writing in English for a
+ * Spanish-market client wants a Spanish presenter. A wrong refusal leaves the user nothing
+ * to type, so a judge that cannot answer, or a company whose Knowledge cannot be read, lets
+ * the command through.
  */
+import type { Judge } from "./jev.ts";
+/**
+ * Three judgments, each its own Noul in one request: an accent fits when the user writes in
+ * its language, or asked for it, or it names no language at all. Asked as one question, a
+ * face ("eher südländischer Typ") read as a request for Italian (0.79). Re-run
+ * `scripts/avatar-guard-evals` after changing any of them.
+ */
+export declare const ACCENT_WRITTEN_IN_QUESTION: string;
+export declare const ACCENT_ASKED_FOR_QUESTION: string;
+export declare const ACCENT_COMPANY_LANGUAGE_QUESTION: string;
+export declare const ACCENT_NAMES_LANGUAGE_QUESTION = "Does `accent` name a language, a country or a regional accent?";
+/** Each answer is a yes at or above this. Measured in `scripts/avatar-guard-evals`. */
+export declare const ACCENT_HELD = 0.5;
+/** The company's own description (COMPANY.md in the Company Workspace), or undefined when unreadable. */
+export type CompanyText = () => Promise<string | undefined>;
 /** The `--accent` value in a `baker avatars create|update` command, if it has one. */
 export declare function accentFrom(command: string): string | null;
 /** The refusal, or null when the accent is consistent with what the user asked for. */
@@ -30,5 +48,5 @@ export declare function accentContradictsUser(command: string | undefined, userT
  * the UK, in English" — and writes the next in Spanish had their own decision refused,
  * with nothing they could type to get past it short of repeating themselves every time.
  */
-priorUserText?: string): string | null;
+priorUserText: string | undefined, judge: Judge, companyText?: CompanyText): Promise<string | null>;
 //# sourceMappingURL=avatar-accent.d.ts.map

package/dist/hono/avatar-accent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avatar-accent.d.ts","sourceRoot":"","sources":["../../src/hono/avatar-accent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAmCH,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIzD;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS;AAC5B;;;;;;;GAOG;AACH,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CAkBf"}
+{"version":3,"file":"avatar-accent.d.ts","sourceRoot":"","sources":["../../src/hono/avatar-accent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGtC;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAES,CAAC;AACjD,eAAO,MAAM,yBAAyB,QAG6E,CAAC;AACpH,eAAO,MAAM,gCAAgC,QAEwD,CAAC;AACtG,eAAO,MAAM,8BAA8B,mEAAmE,CAAC;AAC/G,uFAAuF;AACvF,eAAO,MAAM,WAAW,MAAM,CAAC;AAM/B,yGAAyG;AACzG,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAO5D,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIzD;AAED,uFAAuF;AACvF,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS;AAC5B;;;;;;;GAOG;AACH,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,KAAK,EAAE,KAAK,EACZ,WAAW,GAAE,WAA6B,GACzC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqCxB"}

package/dist/hono/avatar-accent.js

@@ -1,51 +1,28 @@
+import { bridgeRuntimeFiles, runtimeFileStore } from "./runtime-files.js";
 /**
- * Refuses an avatar cast to speak a language the user never asked for.
- *
- * `--accent` decides the LANGUAGE of every clip that avatar appears in, and the agent
- * keeps reading it off the person's looks instead of off the conversation. Three runs in
- * a row, each from the same Spanish sentence asking for "aspecto europeo" — a face:
- *
- *   --accent "Dutch, neutral European accent"
- *   --accent "German, clear and authoritative"
- *   --accent "English from UK, Southern England accent"
- *
- * The first shipped: a Spanish client's ad, spoken in German. The rule is in the flag's
- * own description, in the creation hint and in the family doc by now, so this is the
- * layer left.
- *
- * Narrow by construction — it only fires when the user is clearly writing Spanish AND
- * the accent clearly names another language AND nothing the user said asks for that
- * language or market. An ad a Spaniard genuinely wants in English says so, and then
- * this stays out of the way.
+ * Three judgments, each its own Noul in one request: an accent fits when the user writes in
+ * its language, or asked for it, or it names no language at all. Asked as one question, a
+ * face ("eher südländischer Typ") read as a request for Italian (0.79). Re-run
+ * `scripts/avatar-guard-evals` after changing any of them.
  */
-/** Words that are common in Spanish and rare-to-absent in English/German/Dutch. */
-const SPANISH_MARKERS = /\b(que|para|con|una?|los|las|del|por|pero|como|cuando|donde|porque|nuestro|nuestra|quiero|hacer|tiene|está|más|también|anuncio|vídeo|video|cliente|empresa)\b/gi;
-/** Languages an accent can name, with the words that would justify asking for one. */
-const FOREIGN_LANGUAGES = [
-    {
-        name: "English",
-        accent: /\b(english|british|american|uk|usa|australian|irish|scottish)\b/i,
-        justification: /\b(ingl[ée]s|inglesa|uk|reino unido|brit[áa]nic|estados unidos|usa|americano|irlanda|australia)\b/i,
-    },
-    {
-        name: "German",
-        accent: /\b(german|austrian|deutsch)\b/i,
-        justification: /\b(alem[áa]n|alemana|alemania|austria)\b/i,
-    },
-    { name: "French", accent: /\b(french|parisian)\b/i, justification: /\b(franc[ée]s|francesa|francia)\b/i },
-    {
-        name: "Dutch",
-        accent: /\b(dutch|netherlands|flemish)\b/i,
-        justification: /\b(holand[ée]s|neerland[ée]s|pa[íi]ses bajos|holanda|b[ée]lgica)\b/i,
-    },
-    { name: "Italian", accent: /\b(italian)\b/i, justification: /\b(italiano|italiana|italia)\b/i },
-    { name: "Portuguese", accent: /\b(portuguese|brazilian)\b/i, justification: /\b(portugu[ée]s|portugal|brasil)\b/i },
-];
-/** Enough Spanish function words that the user is plainly writing Spanish. */
-const SPANISH_CONFIDENCE = 3;
-function writesSpanish(text) {
-    return (text.match(SPANISH_MARKERS) ?? []).length >= SPANISH_CONFIDENCE;
-}
+export const ACCENT_WRITTEN_IN_QUESTION = "`accent` is how an ad's presenter will speak. Is `conversation` written in the language `accent` names? " +
+    "Any regional accent of that language counts.";
+export const ACCENT_ASKED_FOR_QUESTION = "`accent` is how an ad's presenter will speak. Does `conversation` ask for the ad or presenter in the language " +
+    "`accent` names, or for a country, region or market where that language is spoken? Asking for how the " +
+    "presenter should look (a European, Nordic, Asian, Mediterranean or American look) is not asking for a language.";
+export const ACCENT_COMPANY_LANGUAGE_QUESTION = "`accent` is how an ad's presenter will speak. `company` is the company's own description of itself. " +
+    "Is `company` written in the language `accent` names? Any regional accent of that language counts.";
+export const ACCENT_NAMES_LANGUAGE_QUESTION = "Does `accent` name a language, a country or a regional accent?";
+/** Each answer is a yes at or above this. Measured in `scripts/avatar-guard-evals`. */
+export const ACCENT_HELD = 0.5;
+/** The most of the conversation read, from its end: the latest turns carry the decision. */
+const CONVERSATION_CHARS = 12_000;
+/** The most of the company's Knowledge read, from its start: enough to tell its language. */
+const COMPANY_CHARS = 4_000;
+const readCompanyFile = async () => {
+    const read = await runtimeFileStore.readText(bridgeRuntimeFiles.companyFile());
+    return read.ok ? read.value : undefined;
+};
 /** The `--accent` value in a `baker avatars create|update` command, if it has one. */
 export function accentFrom(command) {
     if (!/\bbaker\s+avatars\s+(create|update)\b/.test(command))
@@ -54,7 +31,7 @@ export function accentFrom(command) {
     return match ? (match[2] ?? match[3] ?? match[4] ?? null) : null;
 }
 /** The refusal, or null when the accent is consistent with what the user asked for. */
-export function accentContradictsUser(command, userText, 
+export async function accentContradictsUser(command, userText, 
 /**
  * What the user said EARLIER in the same conversation.
  *
@@ -63,24 +40,38 @@ export function accentContradictsUser(command, userText,
  * the UK, in English" — and writes the next in Spanish had their own decision refused,
  * with nothing they could type to get past it short of repeating themselves every time.
  */
-priorUserText) {
-    const said = [priorUserText ?? "", userText ?? ""].join(" ").trim();
-    if (!command || !said || !writesSpanish(said))
+priorUserText, judge, companyText = readCompanyFile) {
+    const said = [priorUserText ?? "", userText ?? ""].join("\n").trim().slice(-CONVERSATION_CHARS);
+    const accent = command ? accentFrom(command) : null;
+    if (!accent || !said)
+        return null;
+    const company = (await companyText())?.trim().slice(0, COMPANY_CHARS);
+    if (!company)
         return null;
-    const accent = accentFrom(command);
-    if (!accent)
+    const answers = await judge([
+        ...[ACCENT_WRITTEN_IN_QUESTION, ACCENT_ASKED_FOR_QUESTION, ACCENT_NAMES_LANGUAGE_QUESTION].map((question) => ({
+            instructions: { accent, conversation: said, question },
+        })),
+        { instructions: { accent, company, question: ACCENT_COMPANY_LANGUAGE_QUESTION } },
+    ]);
+    const [writtenIn, askedFor, namesLanguage, companyWritesIt] = answers ?? [];
+    if (writtenIn === undefined ||
+        askedFor === undefined ||
+        namesLanguage === undefined ||
+        companyWritesIt === undefined) {
+        return null;
+    }
+    if (writtenIn >= ACCENT_HELD ||
+        askedFor >= ACCENT_HELD ||
+        companyWritesIt >= ACCENT_HELD ||
+        namesLanguage < ACCENT_HELD) {
         return null;
-    for (const language of FOREIGN_LANGUAGES) {
-        if (!language.accent.test(accent))
-            continue;
-        if (language.justification.test(said))
-            return null;
-        return (`Blocked: --accent "${accent}" makes this avatar speak ${language.name}, and the user is writing to you in ` +
-            `Spanish without asking for ${language.name} anywhere. --accent sets the LANGUAGE of every clip, not the ` +
-            `person's looks — "aspecto europeo", "Nordic" and "Mediterranean" describe a FACE and belong in --subject. ` +
-            `Use the user's own language (e.g. --accent "Spanish from Spain, Madrid accent"). If the ad really is for a ` +
-            `${language.name}-speaking market, ask them first and say so in the same turn.`);
     }
-    return null;
+    return (`Blocked: --accent "${accent}" sets the language this avatar speaks, and nothing points to it: it is not the ` +
+        `language the user writes to you in, nor one they asked for, nor the language the company's own content is ` +
+        `written in. --accent sets the LANGUAGE of every clip, not the person's looks — "aspecto europeo", "Nordic" ` +
+        `and "Mediterranean" describe a FACE and belong in --subject. Use the language of the market the ad is for: ` +
+        `the user's own, or the company's. If the ad really is for a market that speaks another language, ask them ` +
+        `first and say so in the same turn.`);
 }
 //# sourceMappingURL=avatar-accent.js.map

package/dist/hono/avatar-accent.js.map

@@ -1 +1 @@
-{"version":3,"file":"avatar-accent.js","sourceRoot":"","sources":["../../src/hono/avatar-accent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,mFAAmF;AACnF,MAAM,eAAe,GACnB,iKAAiK,CAAC;AAEpK,sFAAsF;AACtF,MAAM,iBAAiB,GAA8D;IACnF;QACE,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,kEAAkE;QAC1E,aAAa,EAAE,oGAAoG;KACpH;IACD;QACE,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,gCAAgC;QACxC,aAAa,EAAE,2CAA2C;KAC3D;IACD,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,wBAAwB,EAAE,aAAa,EAAE,oCAAoC,EAAE;IACzG;QACE,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,kCAAkC;QAC1C,aAAa,EAAE,qEAAqE;KACrF;IACD,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,iCAAiC,EAAE;IAC/F,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,6BAA6B,EAAE,aAAa,EAAE,qCAAqC,EAAE;CACpH,CAAC;AAEF,8EAA8E;AAC9E,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,kBAAkB,CAAC;AAC1E,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,IAAI,CAAC,uCAAuC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,MAAM,KAAK,GAAG,8CAA8C,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnE,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,qBAAqB,CACnC,OAA2B,EAC3B,QAA4B;AAC5B;;;;;;;GAOG;AACH,aAAsB;IAEtB,MAAM,IAAI,GAAG,CAAC,aAAa,IAAI,EAAE,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,KAAK,MAAM,QAAQ,IAAI,iBAAiB,EAAE,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,SAAS;QAC5C,IAAI,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACnD,OAAO,CACL,sBAAsB,MAAM,6BAA6B,QAAQ,CAAC,IAAI,sCAAsC;YAC5G,8BAA8B,QAAQ,CAAC,IAAI,+DAA+D;YAC1G,4GAA4G;YAC5G,6GAA6G;YAC7G,GAAG,QAAQ,CAAC,IAAI,+DAA+D,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"avatar-accent.js","sourceRoot":"","sources":["../../src/hono/avatar-accent.ts"],"names":[],"mappings":"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"}

package/dist/hono/avatar-accent.test.js

@@ -1,48 +1,77 @@
 import { describe, expect, it } from "vitest";
-import { accentContradictsUser, accentFrom } from "./avatar-accent.js";
-const ASK = "Crea un avatar para un anuncio de TikTok en el que vendamos la instalación de placas solares para ahorrar dinero, con aspecto europeo.";
-describe("accentContradictsUser", () => {
-    it("refuses each of the three accents that shipped from this exact sentence", () => {
-        for (const accent of [
-            "Dutch, neutral European accent",
-            "German, clear and authoritative",
-            "English from UK, Southern England accent",
-        ]) {
-            const refusal = accentContradictsUser(`baker avatars create --name "X" --accent "${accent}"`, ASK);
-            expect(refusal).toContain("--accent sets the LANGUAGE");
+import { ACCENT_ASKED_FOR_QUESTION, ACCENT_NAMES_LANGUAGE_QUESTION, accentContradictsUser, accentFrom, } from "./avatar-accent.js";
+const CREATE = (accent) => `baker avatars create --name "X" --accent "${accent}"`;
+/** A company whose Knowledge `fitsWhen` never reads as written in the accent's language. */
+const COMPANY = async () => "# Słoneczne Panele\n\nMontujemy panele słoneczne w Polsce.";
+/**
+ * A judge that reads every accent as naming a language unless it mentions `noLanguage`, and
+ * holds it asked for only when the conversation mentions `marker`. The user never writes in it.
+ */
+function fitsWhen(marker, noLanguage = "warm") {
+    return async (questions) => questions.map(({ instructions }) => {
+        if (instructions.question === ACCENT_NAMES_LANGUAGE_QUESTION) {
+            return instructions.accent?.includes(noLanguage) ? 0.02 : 0.9;
+        }
+        if (instructions.question === ACCENT_ASKED_FOR_QUESTION) {
+            return instructions.conversation?.includes(marker) ? 0.9 : 0.1;
         }
+        return 0.05;
     });
-    it("allows the user's own language", () => {
-        expect(accentContradictsUser('baker avatars create --name "X" --accent "Spanish from Spain, Madrid accent"', ASK)).toBeNull();
+}
+describe("accentContradictsUser", () => {
+    it("refuses an accent the judge reads as a language nobody asked for, in any language the user writes", async () => {
+        const refusal = await accentContradictsUser(CREATE("Swedish, neutral"), "Zrób awatara do reklamy na TikToka o panelach słonecznych, ma wyglądać skandynawsko.", undefined, fitsWhen("po szwedzku"), COMPANY);
+        expect(refusal).toContain("--accent sets the LANGUAGE");
+        expect(refusal).toContain("the market the ad is for");
     });
-    it("allows a foreign language the user actually asked for", () => {
-        // A Spanish speaker selling into the UK is a real case and must not be blocked.
-        expect(accentContradictsUser('baker avatars create --name "X" --accent "English from UK"', "Quiero un anuncio para el mercado de UK, en inglés, sobre placas solares")).toBeNull();
+    it("lets the command through when the company's Knowledge cannot be read, rather than refuse on a guess", async () => {
+        const refusal = await accentContradictsUser(CREATE("Swedish, neutral"), "Zrób awatara do reklamy na TikToka o panelach słonecznych.", undefined, fitsWhen("po szwedzku"), async () => undefined);
+        expect(refusal).toBeNull();
     });
-    it("stays out of the way when the user is not writing Spanish", () => {
-        expect(accentContradictsUser('baker avatars create --name "X" --accent "German"', "Create an avatar for a TikTok ad about solar panels")).toBeNull();
+    it("allows the language the company's own Knowledge is written in, when the conversation is in another", async () => {
+        // An agency member writing in English for a Spanish-market client: the ad is for the
+        // client's market, so its presenter speaks the client's language.
+        const companyWritesIt = async (questions) => questions.map(({ instructions }) => {
+            if (instructions.question === ACCENT_NAMES_LANGUAGE_QUESTION)
+                return 0.9;
+            return instructions.company?.includes("Clínica dental en Valencia") ? 0.95 : 0.05;
+        });
+        const refusal = await accentContradictsUser(CREATE("Spanish from Spain"), "UGC ad for our summer promo", undefined, companyWritesIt, async () => "# Sonrisa\n\nClínica dental en Valencia con tres sedes.");
+        expect(refusal).toBeNull();
     });
-    it("ignores commands that are not creating an avatar", () => {
-        expect(accentContradictsUser("grep -rn -- --accent docs/", ASK)).toBeNull();
-        expect(accentContradictsUser(undefined, ASK)).toBeNull();
+    it("allows an accent the judge reads as asked for", async () => {
+        const refusal = await accentContradictsUser(CREATE("German, standard"), "Reklama jest na rynek niemiecki, awatar ma mówić po niemiecku.", undefined, fitsWhen("po niemiecku"), COMPANY);
+        expect(refusal).toBeNull();
     });
-    it("reads the accent however it was quoted", () => {
-        expect(accentFrom('baker avatars create --accent "German, firm"')).toBe("German, firm");
-        expect(accentFrom("baker avatars update marta --accent='British English'")).toBe("British English");
+    it("reads what the user said in an earlier turn on the same footing as this one", async () => {
+        // A user who settles the market in one turn and writes the next in Spanish had their
+        // own decision refused, with nothing they could type short of repeating it every time.
+        const refusal = await accentContradictsUser(CREATE("English from UK, Southern England accent"), "Crea el avatar y empieza con el primer clip.", "La campaña es para UK y el anuncio va en inglés.", fitsWhen("para UK"), COMPANY);
+        expect(refusal).toBeNull();
     });
-});
-describe("what the user said in an earlier turn", () => {
-    it("accepts a foreign accent the conversation already established", () => {
-        // The gate reads the turn in front of it. A user who settles the market in one turn —
-        // "the campaign is for the UK, in English" — and then writes the next one in Spanish
-        // got their own decision refused, with nothing they could type to get past it short of
-        // repeating themselves in every message.
-        const refusal = accentContradictsUser('baker avatars create --name "X" --accent "English from UK, Southern England accent"', "Crea el avatar y empieza con el primer clip.", "La campaña es para UK y el anuncio va en inglés.");
+    it("allows the language the user writes in, which nobody has to ask for", async () => {
+        const writesIt = async (questions) => questions.map(({ instructions }) => (instructions.question === ACCENT_ASKED_FOR_QUESTION ? 0.1 : 0.95));
+        const refusal = await accentContradictsUser(CREATE("Polish, Warsaw"), "Zrób awatara do reklamy.", undefined, writesIt, COMPANY);
         expect(refusal).toBeNull();
     });
-    it("still refuses when nothing in the conversation asked for it", () => {
-        const refusal = accentContradictsUser('baker avatars create --name "X" --accent "English from UK, Southern England accent"', "Crea el avatar y empieza con el primer clip.", "Quiero un anuncio de placas solares para el mercado local.");
-        expect(refusal).toContain("--accent sets the LANGUAGE");
+    it("lets an accent that names no language through: it cannot contradict anything", async () => {
+        const refusal = await accentContradictsUser(CREATE("warm and friendly"), "Crea un avatar para la clínica dental.", undefined, fitsWhen("nothing asked"), COMPANY);
+        expect(refusal).toBeNull();
+    });
+    it("lets the command through when the judge cannot answer, rather than refuse on a guess", async () => {
+        expect(await accentContradictsUser(CREATE("German"), "Hazme un avatar", undefined, async () => null, COMPANY)).toBeNull();
+    });
+    it("ignores commands that set no accent, without asking the judge", async () => {
+        const unreachable = () => Promise.reject(new Error("the judge should not be asked"));
+        expect(await accentContradictsUser("grep -rn -- --accent docs/", "Hazme un avatar", undefined, unreachable)).toBeNull();
+        expect(await accentContradictsUser('baker avatars create --name "X"', "Hazme un avatar", undefined, unreachable)).toBeNull();
+        expect(await accentContradictsUser(undefined, "Hazme un avatar", undefined, unreachable)).toBeNull();
+    });
+});
+describe("accentFrom", () => {
+    it("reads the accent however it was quoted", () => {
+        expect(accentFrom('baker avatars create --accent "German, firm"')).toBe("German, firm");
+        expect(accentFrom("baker avatars update marta --accent='British English'")).toBe("British English");
     });
 });
 //# sourceMappingURL=avatar-accent.test.js.map

package/dist/hono/avatar-accent.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"avatar-accent.test.js","sourceRoot":"","sources":["../../src/hono/avatar-accent.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEvE,MAAM,GAAG,GACP,wIAAwI,CAAC;AAE3I,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,KAAK,MAAM,MAAM,IAAI;YACnB,gCAAgC;YAChC,iCAAiC;YACjC,0CAA0C;SAC3C,EAAE,CAAC;YACF,MAAM,OAAO,GAAG,qBAAqB,CAAC,6CAA6C,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC;YACnG,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CACJ,qBAAqB,CAAC,8EAA8E,EAAE,GAAG,CAAC,CAC3G,CAAC,QAAQ,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,gFAAgF;QAChF,MAAM,CACJ,qBAAqB,CACnB,4DAA4D,EAC5D,0EAA0E,CAC3E,CACF,CAAC,QAAQ,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CACJ,qBAAqB,CACnB,mDAAmD,EACnD,qDAAqD,CACtD,CACF,CAAC,QAAQ,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,qBAAqB,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5E,MAAM,CAAC,qBAAqB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,UAAU,CAAC,8CAA8C,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACxF,MAAM,CAAC,UAAU,CAAC,uDAAuD,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACtG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,sFAAsF;QACtF,qFAAqF;QACrF,uFAAuF;QACvF,yCAAyC;QACzC,MAAM,OAAO,GAAG,qBAAqB,CACnC,qFAAqF,EACrF,8CAA8C,EAC9C,kDAAkD,CACnD,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,OAAO,GAAG,qBAAqB,CACnC,qFAAqF,EACrF,8CAA8C,EAC9C,4DAA4D,CAC7D,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"avatar-accent.test.js","sourceRoot":"","sources":["../../src/hono/avatar-accent.test.ts"],"names":[],"mappings":"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"}

package/dist/hono/avatar-face-question.d.ts

@@ -11,15 +11,32 @@
  * before asking anyway — three times, in both casting modes. A rule that survives being
  * read needs a gate, and `routeToolUse` is the one path every question travels.
  *
- * Its own module so it can be tested as the pure function it is, without the bridge's
- * environment having to exist.
+ * Read by Jev, so a face asked for in any language or wording is caught, with no list of
+ * face words to fall out of date. Its own module, with the judge as a parameter, so it can be
+ * tested without the network or the bridge's environment.
  */
+import type { Judge } from "./jev.ts";
+/**
+ * The two questions Jev answers about each question the agent asks, as the user would read
+ * it: is it a face pick, and is it about a page. A presenter section on a landing is a photo
+ * the user already has, which the casting picker cannot offer, and asked in one question it
+ * read as a face pick (0.81). Kept word for word in step with the scaffold's
+ * guard-avatar-face-question hook, the same rule one layer in. Re-run
+ * `scripts/avatar-guard-evals` after changing either.
+ */
+export declare const FACE_PICK_QUESTION: string;
+export declare const ON_A_PAGE_QUESTION = "Does `asked` mention a website, a landing page or a section of a web page?";
+/** At or above, a face pick; below, not about a page. Measured in `scripts/avatar-guard-evals`. */
+export declare const FACE_PICK_HELD = 0.5;
+export declare const ON_A_PAGE_HELD = 0.5;
 /** What the agent is told when this is refused — names both ways out. */
 export declare const FACE_QUESTION_MESSAGE: string;
+/** One question as the user would read it: header, question, then each option. Pure. */
+export declare function questionText(question: unknown): string;
 /**
- * Deliberately narrow, because a wrong refusal costs the user a real question: it fires
- * only when the text is about a face AND about an avatar or a casting. An avatar's
- * accent, its wardrobe, whether to use one at all — all still askable.
+ * Whether any question asks the user to pick a face. Each question is put to the judge as
+ * two Nouls, all in one request. A wrong refusal costs the user a real question, so a judge that
+ * cannot answer lets every question through.
  */
-export declare function asksForAvatarFace(input: Record<string, unknown> | undefined): boolean;
+export declare function asksForAvatarFace(input: Record<string, unknown> | undefined, judge: Judge): Promise<boolean>;
 //# sourceMappingURL=avatar-face-question.d.ts.map

package/dist/hono/avatar-face-question.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avatar-face-question.d.ts","sourceRoot":"","sources":["../../src/hono/avatar-face-question.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAwCH,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,QAK4B,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,OAAO,CAqBrF"}
+{"version":3,"file":"avatar-face-question.d.ts","sourceRoot":"","sources":["../../src/hono/avatar-face-question.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAKpB,CAAC;AACZ,eAAO,MAAM,kBAAkB,+EAA+E,CAAC;AAC/G,mGAAmG;AACnG,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,QAK4B,CAAC;AAE/D,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAWtD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAalH"}

package/dist/hono/avatar-face-question.js

@@ -11,78 +11,67 @@
  * before asking anyway — three times, in both casting modes. A rule that survives being
  * read needs a gate, and `routeToolUse` is the one path every question travels.
  *
- * Its own module so it can be tested as the pure function it is, without the bridge's
- * environment having to exist.
+ * Read by Jev, so a face asked for in any language or wording is caught, with no list of
+ * face words to fall out of date. Its own module, with the judge as a parameter, so it can be
+ * tested without the network or the bridge's environment.
  */
-/** A face, in the languages the product is used in. `typeface` must not match. */
-const FACE_WORD = /(?<!type)\b(faces?|rostros?|caras?|retratos?|portraits?)\b/i;
 /**
- * `face` the VERB, which describes what the avatar does rather than whose it is.
- * "Should Marta face the camera or look away?" is a direction, not a casting call.
+ * The two questions Jev answers about each question the agent asks, as the user would read
+ * it: is it a face pick, and is it about a page. A presenter section on a landing is a photo
+ * the user already has, which the casting picker cannot offer, and asked in one question it
+ * read as a face pick (0.81). Kept word for word in step with the scaffold's
+ * guard-avatar-face-question hook, the same rule one layer in. Re-run
+ * `scripts/avatar-guard-evals` after changing either.
  */
-const FACE_VERB = /\bfaces?\s+(?:the\s+|el\s+|la\s+|a\s+la\s+)?(?:camera|c[áa]mara|lens|viewer|audience|forward|away|left|right|towards?|hacia)\b/gi;
-/**
- * What makes a face an avatar's face rather than anything else.
- *
- * Two tiers, because they are not equally certain. `avatar` and `casting` name the
- * thing the picker exists for and nothing else. `presenter`/`presentadora` names a
- * ROLE, and a client's landing page has one of those too — a real person, in a photo
- * they already own, that `request_avatar_casting` cannot offer and cannot replace.
- */
-const CASTING_WORD = /\b(avatars?|casting)\b/i;
-const ROLE_WORD = /\b(presentador[ao]s?|presenters?)\b/i;
-/**
- * An asset the user ALREADY has, which is never a face waiting to be cast. Only
- * consulted for the weak `ROLE_WORD` tier: under an explicit avatar or casting
- * header the picker is still the answer however the question is worded.
- */
-const EXISTING_ASSET_WORD = /\b(landings?|p[áa]ginas?|pages?|secci[óo]n|seccion|sections?|hero|fotos?|photos?|im[áa]genes|imagen|images?)\b/i;
-/**
- * "Portrait" the ORIENTATION, which is not a face at all.
- *
- * An aspect ratio beside it, or a sibling that names a frame shape, says the question
- * is about the shape of the frame. Under an "Avatar" header that question read as a
- * face picker and was refused — and a wrong refusal costs the user a real question
- * this tool is exactly right for. `vertical` is in the list because it is the
- * commonest phrasing of it and the only one Spanish uses; without it the exemption
- * only ever fired on a question that happened to offer landscape as the alternative.
- */
-const ORIENTATION_WORD = /\b(\d{1,2}:\d{1,2}|landscape|square|horizontal|vertical|apaisado|cuadrado|aspect ratio|relaci[óo]n de aspecto)\b/i;
+export const FACE_PICK_QUESTION = "`asked` is a question an AI assistant puts to a marketer while making a video ad with a generated presenter " +
+    "(an avatar), shown as text with options. Does it ask the marketer to pick which person the presenter is, by " +
+    "their face, age, hair or general appearance? Not when it asks about the video format or orientation, where " +
+    "the presenter looks or how they move, their accent, language, voice or clothes, or whether to use a presenter " +
+    "at all.";
+export const ON_A_PAGE_QUESTION = "Does `asked` mention a website, a landing page or a section of a web page?";
+/** At or above, a face pick; below, not about a page. Measured in `scripts/avatar-guard-evals`. */
+export const FACE_PICK_HELD = 0.5;
+export const ON_A_PAGE_HELD = 0.5;
 /** What the agent is told when this is refused — names both ways out. */
 export const FACE_QUESTION_MESSAGE = "Blocked: this tool renders text, so it cannot show a face — the user would be choosing between descriptions of " +
     "people they cannot see. If they should choose, invoke the request_avatar_casting TOOL instead — as a tool call with " +
     "avatarHandle, never as a shell command — it renders " +
     "the real portraits and blocks until they pick. If nobody is there to ask, create the avatar with --face auto, ask " +
     "nothing, and do not describe the resulting face as chosen.";
+/** One question as the user would read it: header, question, then each option. Pure. */
+export function questionText(question) {
+    if (typeof question !== "object" || question === null)
+        return "";
+    const { header, question: asked, options } = question;
+    const lines = [[header, asked].filter((part) => typeof part === "string" && part.trim()).join(" — ")];
+    for (const option of Array.isArray(options) ? options : []) {
+        if (typeof option !== "object" || option === null)
+            continue;
+        const { label, description } = option;
+        const parts = [label, description].filter((part) => typeof part === "string" && part.trim());
+        if (parts.length > 0)
+            lines.push(`- ${parts.join(": ")}`);
+    }
+    return lines.join("\n").trim();
+}
 /**
- * Deliberately narrow, because a wrong refusal costs the user a real question: it fires
- * only when the text is about a face AND about an avatar or a casting. An avatar's
- * accent, its wardrobe, whether to use one at all — all still askable.
+ * Whether any question asks the user to pick a face. Each question is put to the judge as
+ * two Nouls, all in one request. A wrong refusal costs the user a real question, so a judge that
+ * cannot answer lets every question through.
  */
-export function asksForAvatarFace(input) {
+export async function asksForAvatarFace(input, judge) {
     const questions = input?.questions;
     if (!Array.isArray(questions))
         return false;
-    return questions.some((question) => {
-        const q = question;
-        const options = Array.isArray(q.options)
-            ? q.options
-                .map((option) => {
-                const o = option;
-                return `${String(o?.label ?? "")} ${String(o?.description ?? "")}`;
-            })
-                .join(" ")
-            : "";
-        // The verb is dropped before anything else looks for a face, so a question that
-        // only ever used `face` that way has no face in it at all.
-        const text = `${String(q.header ?? "")} ${String(q.question ?? "")} ${options}`.replace(FACE_VERB, " ");
-        if (ORIENTATION_WORD.test(text) && !/(faces?|rostros?|caras?)\b/i.test(text))
-            return false;
-        if (!FACE_WORD.test(text))
-            return false;
-        if (CASTING_WORD.test(text))
-            return true;
-        return ROLE_WORD.test(text) && !EXISTING_ASSET_WORD.test(text);
-    });
+    const asked = questions.map(questionText).filter(Boolean);
+    if (asked.length === 0)
+        return false;
+    const answers = await judge(asked.flatMap((text) => [
+        { instructions: { asked: text, question: FACE_PICK_QUESTION } },
+        { instructions: { asked: text, question: ON_A_PAGE_QUESTION } },
+    ]));
+    if (!answers)
+        return false;
+    return asked.some((_, i) => (answers[2 * i] ?? 0) >= FACE_PICK_HELD && (answers[2 * i + 1] ?? 1) < ON_A_PAGE_HELD);
 }
 //# sourceMappingURL=avatar-face-question.js.map

package/dist/hono/avatar-face-question.js.map

@@ -1 +1 @@
-{"version":3,"file":"avatar-face-question.js","sourceRoot":"","sources":["../../src/hono/avatar-face-question.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,kFAAkF;AAClF,MAAM,SAAS,GAAG,6DAA6D,CAAC;AAChF;;;GAGG;AACH,MAAM,SAAS,GACb,kIAAkI,CAAC;AACrI;;;;;;;GAOG;AACH,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAC/C,MAAM,SAAS,GAAG,sCAAsC,CAAC;AACzD;;;;GAIG;AACH,MAAM,mBAAmB,GACvB,iHAAiH,CAAC;AACpH;;;;;;;;;GASG;AACH,MAAM,gBAAgB,GACpB,mHAAmH,CAAC;AAEtH,yEAAyE;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAChC,iHAAiH;IACjH,sHAAsH;IACtH,sDAAsD;IACtD,oHAAoH;IACpH,4DAA4D,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA0C;IAC1E,MAAM,SAAS,GAAG,KAAK,EAAE,SAAS,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QACjC,MAAM,CAAC,GAAG,QAAuE,CAAC;QAClF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACtC,CAAC,CAAC,CAAC,CAAC,OAAO;iBACN,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;gBACd,MAAM,CAAC,GAAG,MAAoD,CAAC;gBAC/D,OAAO,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,WAAW,IAAI,EAAE,CAAC,EAAE,CAAC;YACrE,CAAC,CAAC;iBACD,IAAI,CAAC,GAAG,CAAC;YACd,CAAC,CAAC,EAAE,CAAC;QACP,gFAAgF;QAChF,2DAA2D;QAC3D,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACxG,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3F,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"avatar-face-question.js","sourceRoot":"","sources":["../../src/hono/avatar-face-question.ts"],"names":[],"mappings":"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"}