@data-fair/lib-agents-sim 0.2.0 → 0.3.0

package/README.md

@@ -68,6 +68,11 @@ chat embedded in an iframe (the common case for a host application), pass
 *is* the page, pass `page` itself — the driver's selectors are identical
 either way.
 
+The driver matches the composer's visible strings, which the chat renders in the
+session's locale. Pass the locale your application runs in — `createChatDriver(root,
+{ locale: 'fr' })` — or the run dies as a 15-minute "element not found" with
+nothing pointing at the cause. The default is `'en'`.
+
 ```ts
 import { test } from '@playwright/test'
 import {

package/chat-driver.d.ts

@@ -9,11 +9,22 @@
  * AgentChatInput renders a Stop button while streaming and a Send button
  * otherwise. Waiting for text would end the turn at the first token of a
  * multi-step tool conversation.
+ *
+ * The composer's strings are locale-dependent; `readConversation`'s are not.
+ * Pass the locale the host application runs in — the default is English.
  */
 import { type Page, type FrameLocator } from '@playwright/test';
 export type ChatRoot = Page | FrameLocator;
+export type ChatDriverLocale = 'fr' | 'en';
+export declare function chatDriverStrings(locale: ChatDriverLocale): {
+    input: string;
+    send: string;
+    stop: string;
+};
 export declare const TURN_TIMEOUT_MS: number;
-export declare function createChatDriver(root: ChatRoot): {
+export declare function createChatDriver(root: ChatRoot, opts?: {
+    locale?: ChatDriverLocale;
+}): {
     sendMessage(text: string): Promise<void>;
     waitForTurn(timeoutMs?: number): Promise<void>;
     readConversation(): Promise<{

package/chat-driver.js

@@ -9,21 +9,41 @@
  * AgentChatInput renders a Stop button while streaming and a Send button
  * otherwise. Waiting for text would end the turn at the first token of a
  * multi-step tool conversation.
+ *
+ * The composer's strings are locale-dependent; `readConversation`'s are not.
+ * Pass the locale the host application runs in — the default is English.
  */
 import { expect } from '@playwright/test';
-const INPUT = 'Type your message...';
+/**
+ * The chat takes its locale from the session (`i18n_lang`), so a host
+ * application running in French renders a French composer. These are the only
+ * locale-dependent selectors: `readConversation` matches on classes.
+ */
+const STRINGS = {
+    en: { input: 'Type your message...', send: 'Send', stop: 'Stop' },
+    fr: { input: 'Tapez votre message...', send: 'Envoyer', stop: 'Arrêter' }
+};
+export function chatDriverStrings(locale) {
+    const strings = STRINGS[locale];
+    // Throw rather than fall back: a silent fallback turns a one-word config
+    // mistake into a timeout with no diagnosis.
+    if (!strings)
+        throw new Error(`unsupported chat locale: ${locale} (have: ${Object.keys(STRINGS).join(', ')})`);
+    return strings;
+}
 // The app's own watchdog is a 90s IDLE timer that re-arms per stream part, so a
 // legitimate multi-step turn has no fixed ceiling on total time. This bounds the
 // harness generously rather than recording a slow-but-working turn as a failure.
 export const TURN_TIMEOUT_MS = 10 * 60 * 1000;
-export function createChatDriver(root) {
+export function createChatDriver(root, opts = {}) {
+    const strings = chatDriverStrings(opts.locale ?? 'en');
     return {
         async sendMessage(text) {
-            await root.getByPlaceholder(INPUT).fill(text);
-            await root.getByRole('button', { name: 'Send' }).click();
+            await root.getByPlaceholder(strings.input).fill(text);
+            await root.getByRole('button', { name: strings.send }).click();
         },
         async waitForTurn(timeoutMs = TURN_TIMEOUT_MS) {
-            const stop = root.getByRole('button', { name: 'Stop' });
+            const stop = root.getByRole('button', { name: strings.stop });
             // The turn may already be finished by the time we look, so a missing Stop
             // button is not an error — only one that never goes away is.
             await stop.waitFor({ state: 'visible', timeout: 15000 }).catch(() => { });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@data-fair/lib-agents-sim",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Primitives for judged browser simulations of the data-fair agents chat, plus a Claude Code bridge exposing the Agent SDK as an OpenAI-compatible provider.",
   "main": "index.js",
   "type": "module",