@cat-factory/app 0.300.1 → 0.301.0

package/app/stores/assistant.ts

@@ -1,8 +1,20 @@
 import { defineStore } from 'pinia'
 import { computed, ref } from 'vue'
 import type { AssistantAnswer, AssistantCapability, AssistantTurn } from '~/types/domain'
+import type { LoadState } from '~/types/load-state'
 import { useWorkspaceStore } from '~/stores/workspace'
 
+/**
+ * How long the capability read waits before it counts as failed.
+ *
+ * The shared client sets no timeout, so a connection that is accepted and never answered (a proxy
+ * holding it open, a wedged worker) leaves the GET pending for ever. Without a deadline that is a
+ * modal whose read never settles: no answer, no failure, and therefore no retry either, since the
+ * retry lives in what a FAILED read puts on screen. The read itself is a tiny in-memory answer on
+ * the backend, so anything past a few seconds is already a connection that is not coming back.
+ */
+const CAPABILITY_DEADLINE_MS = 10_000
+
 /**
  * In-app assistant state: what this deployment's assistant can do, and the last turn's outcome.
  *
@@ -11,25 +23,78 @@ import { useWorkspaceStore } from '~/stores/workspace'
  * live stream like any other, so the frame or task shows up without this store touching the board).
  * Keeping a transcript would be a second, staler record of changes the board already carries.
  *
- * Failures are NOT held here: every refusal a turn can raise is a `DomainError` the shared error
- * funnel (`usePipelineErrorToast`) already renders translated, copyable and with its request id.
- * The three OUTCOMES are the ones this store keeps, because they are answers rather than errors.
+ * Failures of a TURN are not held here: every refusal a turn can raise is a `DomainError` the
+ * shared error funnel (`usePipelineErrorToast`) already renders translated, copyable and with its
+ * request id. The three OUTCOMES are the ones this store keeps, because they are answers rather
+ * than errors. A failed capability READ is the exception, and it is state rather than a throw: see
+ * `loadCapability`.
  */
 export const useAssistantStore = defineStore('assistant', () => {
   const api = useApi()
   const workspace = useWorkspaceStore()
 
   const capability = ref<AssistantCapability | null>(null)
+  const capabilityRead = ref<LoadState>('idle')
   const turn = ref<AssistantTurn | null>(null)
   const running = ref(false)
 
-  /** Whether a model is wired at all; unknown (not yet read) reads as unavailable. */
+  /**
+   * How many reads have STARTED. Compared before every write, so two overlapping reads settle in
+   * the order they were ISSUED rather than the order they answer: a slow success that lands after
+   * the fast failure that superseded it would otherwise re-offer the box on the older answer.
+   */
+  let reads = 0
+
+  /** Whether a model is wired at all. Only meaningful once `capabilityRead` says `ready`. */
   const available = computed(() => capability.value?.available === true)
   const actions = computed(() => capability.value?.actions ?? [])
 
-  /** Read what the assistant can do here. Idempotent: re-reading replaces the answer. */
+  /**
+   * Read what the assistant can do here. Idempotent: re-reading replaces the answer.
+   *
+   * A re-read KEEPS the answer it already has while it is in flight, so the surface stays on the
+   * fact it can already state instead of dropping back to a spinner every time the modal is
+   * re-opened. Only a failure clears it, because a deployment's model may have gone away with
+   * whatever took the endpoint down.
+   *
+   * The failure is recorded, not thrown. It is reported in place: `error` is what puts the
+   * explanation and the retry button on screen, and toasting it as well would stack a second,
+   * non-dismissing copy of the same sentence over the panel that already says it, once per retry.
+   */
   async function loadCapability(): Promise<void> {
-    capability.value = await api.getAssistantCapability(workspace.requireId())
+    const read = ++reads
+    capabilityRead.value = 'loading'
+    try {
+      const answer = await withDeadline((signal) =>
+        api.getAssistantCapability(workspace.requireId(), signal),
+      )
+      if (read !== reads) return
+      capability.value = answer
+      capabilityRead.value = 'ready'
+    } catch {
+      if (read !== reads) return
+      capability.value = null
+      capabilityRead.value = 'error'
+    }
+  }
+
+  /** Read under {@link CAPABILITY_DEADLINE_MS}, ABORTING the request when it expires. */
+  async function withDeadline(
+    send: (signal: AbortSignal) => Promise<AssistantCapability>,
+  ): Promise<AssistantCapability> {
+    const controller = new AbortController()
+    let timer: ReturnType<typeof setTimeout> | undefined
+    try {
+      return await new Promise<AssistantCapability>((resolve, reject) => {
+        timer = setTimeout(() => {
+          controller.abort()
+          reject(new Error(`Assistant capability read timed out after ${CAPABILITY_DEADLINE_MS}ms`))
+        }, CAPABILITY_DEADLINE_MS)
+        send(controller.signal).then(resolve, reject)
+      })
+    } finally {
+      clearTimeout(timer)
+    }
   }
 
   /**
@@ -65,5 +130,16 @@ export const useAssistantStore = defineStore('assistant', () => {
     turn.value = null
   }
 
-  return { capability, turn, running, available, actions, loadCapability, run, answer, reset }
+  return {
+    capability,
+    capabilityRead,
+    turn,
+    running,
+    available,
+    actions,
+    loadCapability,
+    run,
+    answer,
+    reset,
+  }
 })

package/app/types/domain.ts

@@ -125,6 +125,10 @@ import type { AgentCategory, AgentKind, AgentTier, PipelinePurpose } from '@cat-
 // single source of truth lives in the contracts package.
 export { DOC_KINDS, DOC_KIND_FIELDS } from '@cat-factory/contracts'
 
+// The assistant's prompt cap is a runtime value too: the box states the limit and refuses a
+// submission over it, and the wire schema holds the same number.
+export { ASSISTANT_PROMPT_MAX } from '@cat-factory/contracts'
+
 /** A draggable agent definition shown in the agent palette. Frontend-only. */
 export interface AgentArchetype {
   kind: AgentKind

package/app/types/load-state.ts

@@ -0,0 +1,18 @@
+/**
+ * How far a read has got: the SPA's one vocabulary for load progress.
+ *
+ * Four states rather than a nullable value, because an absent value is not a single fact. "Nobody
+ * asked", "the read is in flight" and "the read failed" need three different answers on screen and
+ * only the middle one is temporary; collapsed into one `null` they all render as whatever the
+ * surface shows for "no data", which is usually the empty state and is wrong for two of them.
+ *
+ * A REFRESH is deliberately not a fifth member. A read that already has an answer keeps it, so a
+ * surface asking "what do I show" reads the value it holds and a surface asking "is something in
+ * flight" reads `loading`; a re-read that downgraded the surface to `loading` would replace a
+ * usable panel with a spinner for a fact it can already state.
+ *
+ * A status carrying a member this does not have keeps its own type (`NotificationSettingsStatus`
+ * distinguishes "the deployment does not offer this" from a failure, which is a fifth fact rather
+ * than a renaming of one of these four).
+ */
+export type LoadState = 'idle' | 'loading' | 'ready' | 'error'

package/app/utils/catalog.ts

@@ -862,6 +862,24 @@ export const SYSTEM_AGENT_META: Record<string, AgentArchetype> = {
     description:
       'Grades each completed agent step (smooth vs chaotic) after a run and recommends prompt/model improvements.',
   },
+  // The in-app assistant routes ONE typed sentence to one action from a closed catalog. Not a
+  // pipeline step (it declares no `category`, so it is never in the palette), but it runs an LLM
+  // on every request, so it needs display metadata here and a per-workspace model in Model
+  // Configuration. Without an entry it inherits the preset's base model like any unnamed kind,
+  // which is the right default; what it lacked was the row an operator pins a different one on,
+  // and a label anywhere a spend rollup names the kind that spent it.
+  assistant: {
+    kind: 'assistant',
+    // Intermediate, not advanced like `kaizen`: the assistant is a surface a person OPENS and
+    // spends on deliberately, several times a day, where Kaizen grades in the background on its
+    // own schedule. A kind whose cost someone can feel should not sit two levels down.
+    tier: 'intermediate',
+    label: 'Assistant',
+    icon: 'i-lucide-sparkles',
+    color: '#38bdf8',
+    description:
+      'Routes a typed request to one action the platform performs on the board (declare a dependency, add a service from a repository, file a task from a tracker issue).',
+  },
   // A polling gate (no model of its own) that watches the released PR's observability
   // signals after merge and escalates to the on-call agent on a regression. NOT in any
   // default pipeline and NOT a standing palette archetype — the palette surfaces it
@@ -913,6 +931,9 @@ export const MODEL_CONFIGURABLE_SYSTEM_KINDS: AgentArchetype[] = [
     // The PR-review Challenge Investigator — pinnable to its own (stronger) model, separately
     // from the reviewer that produced the findings.
     'challenge-investigator',
+    // The in-app assistant: one inline model call per typed request, on the workspace's preset
+    // like every other kind, and pinnable away from it here.
+    'assistant',
   ].map((kind) => SYSTEM_AGENT_META[kind]!),
   // Companions run LLMs but aren't palette-addable (they're producer toggles), so include
   // them here to keep their per-workspace default model pinnable in the Model Defaults panel.

package/i18n/locales/de.json

@@ -1596,6 +1596,16 @@
       "configNoun": "die sensiblen Test-Anmeldedaten",
       "duplicateKey": "Jeder Variablenname muss eindeutig sein."
     },
+    "testingContext": {
+      "title": "Testkontext",
+      "sectionHint": "Freitext dazu, wie dieser Service getestet wird: welche Abläufe wichtig sind, welche Testkonten es gibt und wie man sich damit anmeldet, was die eingespielten Daten bedeuten, was unangetastet bleiben soll. Jeder Tester-Lauf für diesen Service bekommt diesen Text wörtlich, der Probelauf der Umgebung ebenso.",
+      "notSecret": "Dieser Text geht unverändert in den Prompt des Testers. Echte Geheimnisse gehören nicht hierher: Trage sie oben unter „Test-Anmeldedaten“ ein und verweise hier nur über den Variablennamen darauf.",
+      "placeholder": "z. B. als $DEMO_USER anmelden; der eingespielte Mandant ist Acme mit drei Projekten; den Abrechnungsablauf nie ausführen, er belastet eine echte Karte.",
+      "length": "{count} von {max} Zeichen",
+      "save": "Testkontext speichern",
+      "revert": "Änderungen verwerfen",
+      "savedToast": "Testkontext gespeichert"
+    },
     "testConfig": {
       "title": "Testinfrastruktur",
       "hint": "Wie eine Testumgebung für diesen Service aufgesetzt wird, wenn eine Pipeline ihn ausführen muss: keine Infrastruktur, eine Docker-Compose-Datei, Kubernetes-Manifeste oder ein benutzerdefinierter Manifesttyp.",
@@ -4520,9 +4530,13 @@
     "title": "Assistent",
     "intro": "Beschreiben Sie, was erledigt werden soll, und der Assistent führt es auf dem Board aus: eine Abhängigkeit zwischen zwei Services erklären, einen Service über eine Repository-URL hinzufügen oder eine Aufgabe aus einem Tracker-Ticket anlegen.",
     "unavailable": "Für diese Installation ist kein Modell konfiguriert, daher kann der Assistent keine Anfrage lesen. Richten Sie einen Modellanbieter ein, um ihn zu aktivieren.",
+    "reading": "Es wird geprüft, was der Assistent hier tun kann…",
+    "unreadable": "Es konnte nicht geprüft werden, was der Assistent hier tun kann, daher ist das Anfragefeld vorerst ausgeblendet. Versuche es in einem Moment erneut.",
+    "noActions": "Für den Assistenten dieser Installation sind keine Aktionen konfiguriert, daher kann er nichts ausführen. Konfigurieren Sie seine Aktionen, um ihn zu aktivieren.",
     "placeholder": "z. B. der Checkout-Service hängt vom Payments-Service ab",
     "submit": "Ausführen",
     "submitHint": "Strg+Enter, auf dem Mac Cmd+Enter",
+    "tooLong": "Diese Anfrage hat {length} Zeichen, der Assistent liest höchstens {limit}. Kürze sie und starte erneut.",
     "examplesTitle": "Das können Sie fragen",
     "showOnBoard": "Auf dem Board zeigen",
     "declined": "Keine Aktion des Assistenten passt zu dieser Anfrage. Er kann eine Abhängigkeit zwischen zwei Services erklären, einen Service über eine Repository-URL hinzufügen oder eine Aufgabe aus einem Tracker-Ticket anlegen.",

package/i18n/locales/en.json

@@ -1147,6 +1147,22 @@
       "configNoun": "the sensitive test credentials",
       "duplicateKey": "Each variable name must be unique."
     },
+    "testingContext": {
+      "title": "Testing context",
+      "@title": {
+        "description": "Section header for the freeform notes a team writes about how their service should be tested. 'Context' here means background information for whoever tests it, not a programming context object."
+      },
+      "sectionHint": "Freeform notes about how this service is tested: which flows matter, which test accounts exist and how to sign in as one, what the seeded data means, what to leave alone. Every tester run for this service is handed this text word for word, and so is the environment dry run.",
+      "notSecret": "This text goes straight into the tester's prompt, so keep real secrets out of it. Put a secret in Test credentials above and refer to it here by its variable name.",
+      "placeholder": "e.g. sign in as $DEMO_USER; the seeded tenant is Acme with three projects; never run the billing flow, it charges a real card.",
+      "length": "{count} of {max} characters",
+      "@length": {
+        "description": "Character counter under a long text box. {count} is how many characters are typed so far, {max} the limit."
+      },
+      "save": "Save testing context",
+      "revert": "Discard changes",
+      "savedToast": "Testing context saved"
+    },
     "testConfig": {
       "title": "Test infrastructure",
       "hint": "How a test environment is stood up for this service when a pipeline needs to run it: no infrastructure, a Docker Compose file, Kubernetes manifests, or a custom manifest type.",
@@ -5216,9 +5232,16 @@
     "title": "Assistant",
     "intro": "Describe what you want done and the assistant performs it on the board: declare a dependency between two services, add a service from a repository URL, or file a task from a tracker issue.",
     "unavailable": "No model is configured on this deployment, so the assistant cannot read a request. Configure a model provider to enable it.",
+    "reading": "Checking what the assistant can do here…",
+    "unreadable": "Could not check what the assistant can do here, so the request box is hidden for now. Try again in a moment.",
+    "noActions": "This deployment's assistant has no actions configured, so there is nothing it can perform. Configure its actions to enable it.",
+    "@noActions": {
+      "description": "Shown in place of the request box when the deployment wired a model but registered no ACTIONS for the assistant to choose from: the operations it can perform on the board, not buttons in the interface. Distinct from the no-model case above."
+    },
     "placeholder": "e.g. the checkout service depends on the payments service",
     "submit": "Run",
     "submitHint": "Ctrl+Enter, or Cmd+Enter on a Mac",
+    "tooLong": "That request is {length} characters and the assistant reads up to {limit}. Shorten it and run again.",
     "examplesTitle": "What you can ask",
     "showOnBoard": "Show on board",
     "declined": "None of the assistant's actions match that request. It can declare a dependency between two services, add a service from a repository URL, or file a task from a tracker issue.",

package/i18n/locales/es.json

@@ -1051,6 +1051,16 @@
       "configNoun": "las credenciales de prueba sensibles",
       "duplicateKey": "Cada nombre de variable debe ser único."
     },
+    "testingContext": {
+      "title": "Contexto de pruebas",
+      "sectionHint": "Notas libres sobre cómo se prueba este servicio: qué flujos importan, qué cuentas de prueba existen y cómo iniciar sesión con ellas, qué significan los datos precargados y qué no hay que tocar. Cada ejecución del Tester para este servicio recibe este texto tal cual, igual que la prueba en seco del entorno.",
+      "notSecret": "Este texto se envía tal cual al prompt del Tester, así que no pongas secretos reales aquí. Guárdalos arriba, en «Credenciales de prueba», y menciónalos aquí solo por el nombre de la variable.",
+      "placeholder": "p. ej. inicia sesión como $DEMO_USER; el inquilino precargado es Acme con tres proyectos; nunca ejecutes el flujo de facturación, cobra a una tarjeta real.",
+      "length": "{count} de {max} caracteres",
+      "save": "Guardar contexto de pruebas",
+      "revert": "Descartar cambios",
+      "savedToast": "Contexto de pruebas guardado"
+    },
     "testConfig": {
       "title": "Infraestructura de pruebas",
       "hint": "Cómo se levanta un entorno de prueba para este servicio cuando un pipeline necesita ejecutarlo: sin infraestructura, un archivo de Docker Compose, manifiestos de Kubernetes o un tipo de manifiesto personalizado.",
@@ -5031,9 +5041,13 @@
     "title": "Asistente",
     "intro": "Describe lo que quieres hacer y el asistente lo ejecuta en el tablero: declarar una dependencia entre dos servicios, añadir un servicio a partir de la URL de un repositorio o crear una tarea desde una incidencia del rastreador.",
     "unavailable": "Este despliegue no tiene ningún modelo configurado, así que el asistente no puede leer una petición. Configura un proveedor de modelos para habilitarlo.",
+    "reading": "Comprobando qué puede hacer el asistente aquí…",
+    "unreadable": "No se pudo comprobar qué puede hacer el asistente aquí, así que por ahora el cuadro de solicitud está oculto. Vuelve a intentarlo en un momento.",
+    "noActions": "El asistente de este despliegue no tiene ninguna acción configurada, así que no puede realizar nada. Configura sus acciones para habilitarlo.",
     "placeholder": "p. ej. el servicio de checkout depende del servicio de pagos",
     "submit": "Ejecutar",
     "submitHint": "Ctrl+Intro, o Cmd+Intro en un Mac",
+    "tooLong": "Esa solicitud tiene {length} caracteres y el asistente lee hasta {limit}. Acórtala y vuelve a ejecutarla.",
     "examplesTitle": "Qué puedes pedir",
     "showOnBoard": "Ver en el tablero",
     "declined": "Ninguna acción del asistente encaja con esa petición. Puede declarar una dependencia entre dos servicios, añadir un servicio a partir de la URL de un repositorio o crear una tarea desde una incidencia del rastreador.",

package/i18n/locales/fr.json

@@ -1051,6 +1051,16 @@
       "configNoun": "les identifiants de test sensibles",
       "duplicateKey": "Chaque nom de variable doit être unique."
     },
+    "testingContext": {
+      "title": "Contexte de test",
+      "sectionHint": "Notes libres sur la façon de tester ce service : quels parcours comptent, quels comptes de test existent et comment s'y connecter, ce que signifient les données préchargées, ce qu'il ne faut pas toucher. Chaque exécution du testeur pour ce service reçoit ce texte mot pour mot, tout comme l'essai à blanc de l'environnement.",
+      "notSecret": "Ce texte part tel quel dans l'invite du testeur : n'y mettez pas de véritables secrets. Saisissez-les au-dessus, dans « Identifiants de test », et n'y faites référence ici que par le nom de la variable.",
+      "placeholder": "ex. connectez-vous en tant que $DEMO_USER ; le locataire préchargé est Acme avec trois projets ; ne lancez jamais le parcours de facturation, il débite une vraie carte.",
+      "length": "{count} sur {max} caractères",
+      "save": "Enregistrer le contexte de test",
+      "revert": "Annuler les modifications",
+      "savedToast": "Contexte de test enregistré"
+    },
     "testConfig": {
       "title": "Infrastructure de test",
       "hint": "Comment un environnement de test est mis en place pour ce service quand un pipeline doit l'exécuter : sans infrastructure, un fichier Docker Compose, des manifestes Kubernetes ou un type de manifeste personnalisé.",
@@ -5031,9 +5041,13 @@
     "title": "Assistant",
     "intro": "Décrivez ce que vous voulez faire et l'assistant l'exécute sur le tableau : déclarer une dépendance entre deux services, ajouter un service à partir de l'URL d'un dépôt, ou créer une tâche à partir d'un ticket.",
     "unavailable": "Aucun modèle n'est configuré sur ce déploiement, l'assistant ne peut donc pas lire une demande. Configurez un fournisseur de modèles pour l'activer.",
+    "reading": "Vérification de ce que l'assistant peut faire ici…",
+    "unreadable": "Impossible de vérifier ce que l'assistant peut faire ici, le champ de demande est donc masqué pour l'instant. Réessayez dans un instant.",
+    "noActions": "Aucune action n'est configurée pour l'assistant de ce déploiement, il ne peut donc rien exécuter. Configurez ses actions pour l'activer.",
     "placeholder": "ex. le service checkout dépend du service paiements",
     "submit": "Exécuter",
     "submitHint": "Ctrl+Entrée, ou Cmd+Entrée sur un Mac",
+    "tooLong": "Cette demande fait {length} caractères et l'assistant en lit {limit} au maximum. Raccourcissez-la puis relancez.",
     "examplesTitle": "Ce que vous pouvez demander",
     "showOnBoard": "Afficher sur le tableau",
     "declined": "Aucune action de l'assistant ne correspond à cette demande. Il peut déclarer une dépendance entre deux services, ajouter un service à partir de l'URL d'un dépôt, ou créer une tâche à partir d'un ticket.",

package/i18n/locales/he.json

@@ -1051,6 +1051,16 @@
       "configNoun": "פרטי הגישה הרגישים לבדיקה",
       "duplicateKey": "כל שם משתנה חייב להיות ייחודי."
     },
+    "testingContext": {
+      "title": "הקשר לבדיקות",
+      "sectionHint": "טקסט חופשי על אופן הבדיקה של השירות הזה: אילו תהליכים חשובים, אילו חשבונות בדיקה קיימים וכיצד מתחברים איתם, מה המשמעות של הנתונים שנטענו ובמה אסור לגעת. כל הרצת בודק עבור השירות הזה מקבלת את הטקסט הזה מילה במילה, וכך גם הרצת היבש של הסביבה.",
+      "notSecret": "הטקסט הזה נכנס כמו שהוא לפרומפט של הבודק, ולכן אין לכתוב בו סודות אמיתיים. שמרו אותם למעלה, תחת «פרטי גישה לבדיקה», והזכירו אותם כאן רק בשם המשתנה.",
+      "placeholder": "לדוגמה: התחברו כ-$DEMO_USER; הדייר שנטען הוא Acme עם שלושה פרויקטים; לעולם אל תריצו את תהליך החיוב, הוא מחייב כרטיס אמיתי.",
+      "length": "{count} מתוך {max} תווים",
+      "save": "שמירת ההקשר לבדיקות",
+      "revert": "ביטול השינויים",
+      "savedToast": "ההקשר לבדיקות נשמר"
+    },
     "testConfig": {
       "title": "תשתית בדיקות",
       "hint": "כיצד מוקמת סביבת בדיקה לשירות זה כאשר פייפליין צריך להריץ אותו: ללא תשתית, קובץ Docker Compose, מניפסטים של Kubernetes או סוג מניפסט מותאם אישית.",
@@ -5031,9 +5041,13 @@
     "title": "עוזר",
     "intro": "תארו מה צריך לקרות והעוזר יבצע זאת על הלוח: להצהיר על תלות בין שני שירותים, להוסיף שירות מכתובת מאגר או לפתוח משימה מתקלה במעקב.",
     "unavailable": "לא הוגדר מודל בפריסה הזו, לכן העוזר אינו יכול לקרוא בקשה. הגדירו ספק מודלים כדי להפעיל אותו.",
+    "reading": "בודקים מה העוזר יכול לעשות כאן…",
+    "unreadable": "לא הצלחנו לבדוק מה העוזר יכול לעשות כאן, ולכן שדה הבקשה מוסתר בשלב זה. נסו שוב בעוד רגע.",
+    "noActions": "לא הוגדרו פעולות לעוזר בפריסה הזו, ולכן אין לו מה לבצע. הגדירו את הפעולות שלו כדי להפעיל אותו.",
     "placeholder": "למשל: שירות ה-checkout תלוי בשירות התשלומים",
     "submit": "הרץ",
     "submitHint": "Ctrl+Enter, וב-Mac Cmd+Enter",
+    "tooLong": "הבקשה הזאת באורך {length} תווים, והעוזר קורא עד {limit}. קצרו אותה והפעילו שוב.",
     "examplesTitle": "מה אפשר לבקש",
     "showOnBoard": "הצג על הלוח",
     "declined": "אף פעולה של העוזר אינה מתאימה לבקשה הזו. הוא יכול להצהיר על תלות בין שני שירותים, להוסיף שירות מכתובת מאגר או לפתוח משימה מתקלה במעקב.",

package/i18n/locales/it.json

@@ -1596,6 +1596,16 @@
       "configNoun": "le credenziali di test sensibili",
       "duplicateKey": "Ogni nome di variabile deve essere univoco."
     },
+    "testingContext": {
+      "title": "Contesto di test",
+      "sectionHint": "Note libere su come si testa questo servizio: quali flussi contano, quali account di prova esistono e come accedervi, che cosa significano i dati precaricati, che cosa non va toccato. Ogni esecuzione del Tester per questo servizio riceve questo testo alla lettera, così come la prova a vuoto dell'ambiente.",
+      "notSecret": "Questo testo finisce così com'è nel prompt del Tester, quindi non inserirci segreti veri. Mettili sopra, in «Credenziali di test», e qui richiamali solo con il nome della variabile.",
+      "placeholder": "es. accedi come $DEMO_USER; il tenant precaricato è Acme con tre progetti; non eseguire mai il flusso di fatturazione, addebita una carta vera.",
+      "length": "{count} di {max} caratteri",
+      "save": "Salva il contesto di test",
+      "revert": "Annulla le modifiche",
+      "savedToast": "Contesto di test salvato"
+    },
     "testConfig": {
       "title": "Infrastruttura di test",
       "hint": "Come viene predisposto un ambiente di test per questo servizio quando una pipeline deve eseguirlo: nessuna infrastruttura, un file Docker Compose, manifest Kubernetes, o un tipo di manifest personalizzato.",
@@ -4520,9 +4530,13 @@
     "title": "Assistente",
     "intro": "Descrivi cosa vuoi fare e l'assistente lo esegue sulla bacheca: dichiarare una dipendenza fra due servizi, aggiungere un servizio dall'URL di un repository o creare un'attività da una segnalazione del tracker.",
     "unavailable": "Questo deployment non ha un modello configurato, quindi l'assistente non può leggere una richiesta. Configura un provider di modelli per abilitarlo.",
+    "reading": "Verifica di ciò che l'assistente può fare qui…",
+    "unreadable": "Non è stato possibile verificare ciò che l'assistente può fare qui, quindi per ora il campo della richiesta è nascosto. Riprova tra un momento.",
+    "noActions": "L'assistente di questo deployment non ha azioni configurate, quindi non può eseguire nulla. Configura le sue azioni per abilitarlo.",
     "placeholder": "es. il servizio checkout dipende dal servizio pagamenti",
     "submit": "Esegui",
     "submitHint": "Ctrl+Invio, oppure Cmd+Invio su Mac",
+    "tooLong": "Questa richiesta ha {length} caratteri e l'assistente ne legge al massimo {limit}. Accorciala ed esegui di nuovo.",
     "examplesTitle": "Cosa puoi chiedere",
     "showOnBoard": "Mostra sulla bacheca",
     "declined": "Nessuna azione dell'assistente corrisponde a questa richiesta. Può dichiarare una dipendenza fra due servizi, aggiungere un servizio dall'URL di un repository o creare un'attività da una segnalazione del tracker.",

package/i18n/locales/ja.json

@@ -1051,6 +1051,16 @@
       "configNoun": "機密のテスト用認証情報",
       "duplicateKey": "変数名はそれぞれ一意である必要があります。"
     },
+    "testingContext": {
+      "title": "テストの前提情報",
+      "sectionHint": "このサービスをどうテストするかについての自由記述です。重要なフロー、用意されているテストアカウントとそのログイン方法、投入済みデータの意味、触れてはいけない箇所などを書きます。このサービスのテスターは毎回この文章をそのまま渡され、環境のドライランでも同じ文章が使われます。",
+      "notSecret": "この文章はそのままテスターのプロンプトに入ります。本物の秘密情報は書かないでください。秘密情報は上の「テスト用認証情報」に登録し、ここでは変数名だけで参照してください。",
+      "placeholder": "例: $DEMO_USER でログインする。投入済みのテナントは Acme で、プロジェクトが 3 件ある。課金フローは実際のカードに請求されるので絶対に実行しない。",
+      "length": "{max} 文字中 {count} 文字",
+      "save": "前提情報を保存",
+      "revert": "変更を破棄",
+      "savedToast": "テストの前提情報を保存しました"
+    },
     "testConfig": {
       "title": "テストインフラ",
       "hint": "パイプラインがこのサービスを実行する必要があるときに、テスト環境をどう立ち上げるか: インフラなし、Docker Compose ファイル、Kubernetes マニフェスト、またはカスタムマニフェストタイプ。",
@@ -5031,9 +5041,13 @@
     "title": "アシスタント",
     "intro": "やりたいことを書くと、アシスタントがボード上で実行します。サービス間の依存関係の宣言、リポジトリ URL からのサービス追加、トラッカーのイシューからのタスク作成ができます。",
     "unavailable": "このデプロイメントにはモデルが設定されていないため、アシスタントは依頼を読み取れません。モデルプロバイダーを設定して有効にしてください。",
+    "reading": "ここでアシスタントに何ができるかを確認しています…",
+    "unreadable": "ここでアシスタントに何ができるかを確認できなかったため、入力欄はいまは表示されません。少し待ってからもう一度お試しください。",
+    "noActions": "このデプロイメントのアシスタントにはアクションが設定されていないため、実行できる操作がありません。アクションを設定して有効にしてください。",
     "placeholder": "例: checkout サービスは payments サービスに依存している",
     "submit": "実行",
     "submitHint": "Ctrl+Enter、Mac では Cmd+Enter",
+    "tooLong": "このリクエストは {length} 文字ですが、アシスタントが読めるのは {limit} 文字までです。短くしてから実行してください。",
     "examplesTitle": "依頼できること",
     "showOnBoard": "ボードで表示",
     "declined": "この依頼に合う操作はありません。アシスタントができるのは、2 つのサービス間の依存関係の宣言、リポジトリ URL からのサービス追加、トラッカーのイシューからのタスク作成です。",

package/i18n/locales/pl.json

@@ -1051,6 +1051,16 @@
       "configNoun": "wrażliwe poświadczenia testowe",
       "duplicateKey": "Każda nazwa zmiennej musi być unikalna."
     },
+    "testingContext": {
+      "title": "Kontekst testowania",
+      "sectionHint": "Dowolne notatki o tym, jak testuje się tę usługę: które przepływy są ważne, jakie konta testowe istnieją i jak się na nie zalogować, co oznaczają wgrane dane i czego nie ruszać. Każde uruchomienie Testera dla tej usługi dostaje ten tekst dosłownie, tak samo jak próbne uruchomienie środowiska.",
+      "notSecret": "Ten tekst trafia wprost do promptu Testera, więc nie wpisuj tu prawdziwych sekretów. Zapisz je wyżej, w „Poświadczeniach testowych”, i odwołuj się do nich tutaj tylko przez nazwę zmiennej.",
+      "placeholder": "np. zaloguj się jako $DEMO_USER; wgrany najemca to Acme z trzema projektami; nigdy nie uruchamiaj przepływu płatności, obciąża prawdziwą kartę.",
+      "length": "{count} z {max} znaków",
+      "save": "Zapisz kontekst testowania",
+      "revert": "Odrzuć zmiany",
+      "savedToast": "Zapisano kontekst testowania"
+    },
     "testConfig": {
       "title": "Infrastruktura testowa",
       "hint": "Jak stawiane jest środowisko testowe dla tej usługi, gdy potok musi ją uruchomić: bez infrastruktury, plik Docker Compose, manifesty Kubernetes lub niestandardowy typ manifestu.",
@@ -5031,9 +5041,13 @@
     "title": "Asystent",
     "intro": "Opisz, co ma zostać zrobione, a asystent wykona to na tablicy: zadeklaruje zależność między dwiema usługami, doda usługę z adresu repozytorium albo utworzy zadanie ze zgłoszenia w trackerze.",
     "unavailable": "W tym wdrożeniu nie skonfigurowano żadnego modelu, więc asystent nie może odczytać prośby. Skonfiguruj dostawcę modeli, aby go włączyć.",
+    "reading": "Sprawdzamy, co asystent może tu zrobić…",
+    "unreadable": "Nie udało się sprawdzić, co asystent może tu zrobić, więc pole żądania jest na razie ukryte. Spróbuj ponownie za chwilę.",
+    "noActions": "Asystent w tym wdrożeniu nie ma skonfigurowanych żadnych akcji, więc nie może nic wykonać. Skonfiguruj jego akcje, aby go włączyć.",
     "placeholder": "np. usługa checkout zależy od usługi płatności",
     "submit": "Uruchom",
     "submitHint": "Ctrl+Enter, na Macu Cmd+Enter",
+    "tooLong": "To żądanie ma {length} znaków, a asystent czyta najwyżej {limit}. Skróć je i uruchom ponownie.",
     "examplesTitle": "O co możesz poprosić",
     "showOnBoard": "Pokaż na tablicy",
     "declined": "Żadne działanie asystenta nie pasuje do tej prośby. Może zadeklarować zależność między dwiema usługami, dodać usługę z adresu repozytorium albo utworzyć zadanie ze zgłoszenia w trackerze.",

package/i18n/locales/tr.json

@@ -1051,6 +1051,16 @@
       "configNoun": "hassas test kimlik bilgileri",
       "duplicateKey": "Her değişken adı benzersiz olmalıdır."
     },
+    "testingContext": {
+      "title": "Test bağlamı",
+      "sectionHint": "Bu servisin nasıl test edildiğine dair serbest notlar: hangi akışlar önemli, hangi test hesapları var ve bunlarla nasıl oturum açılır, yüklü veriler ne anlama geliyor, neye dokunulmamalı. Bu servis için her Test Edici çalışması bu metni harfi harfine alır; ortamın deneme çalışması da öyle.",
+      "notSecret": "Bu metin doğrudan Test Edici'nin istemine girer, bu yüzden gerçek sırları buraya yazmayın. Onları yukarıdaki «Test kimlik bilgileri» bölümüne kaydedin ve burada yalnızca değişken adıyla anın.",
+      "placeholder": "ör. $DEMO_USER olarak oturum açın; yüklü kiracı üç projeli Acme'dir; faturalama akışını asla çalıştırmayın, gerçek bir kartı borçlandırır.",
+      "length": "{count} / {max} karakter",
+      "save": "Test bağlamını kaydet",
+      "revert": "Değişiklikleri geri al",
+      "savedToast": "Test bağlamı kaydedildi"
+    },
     "testConfig": {
       "title": "Test altyapısı",
       "hint": "Bir pipeline bu servisi çalıştırmak istediğinde test ortamının nasıl kurulacağı: altyapısız, bir Docker Compose dosyası, Kubernetes manifestoları veya özel bir manifest türü.",
@@ -5031,9 +5041,13 @@
     "title": "Asistan",
     "intro": "Ne yapılmasını istediğinizi yazın, asistan bunu panoda gerçekleştirsin: iki servis arasında bağımlılık tanımlamak, bir depo adresinden servis eklemek ya da bir izleyici kaydından görev oluşturmak.",
     "unavailable": "Bu kurulumda yapılandırılmış bir model yok, bu yüzden asistan isteği okuyamıyor. Etkinleştirmek için bir model sağlayıcısı yapılandırın.",
+    "reading": "Asistanın burada neler yapabileceği denetleniyor…",
+    "unreadable": "Asistanın burada neler yapabileceği denetlenemedi, bu yüzden istek alanı şimdilik gizli. Birazdan yeniden deneyin.",
+    "noActions": "Bu kurulumdaki asistan için yapılandırılmış bir eylem yok, bu yüzden hiçbir şey gerçekleştiremiyor. Etkinleştirmek için eylemlerini yapılandırın.",
     "placeholder": "örn. checkout servisi ödemeler servisine bağlıdır",
     "submit": "Çalıştır",
     "submitHint": "Ctrl+Enter, Mac'te Cmd+Enter",
+    "tooLong": "Bu istek {length} karakter, asistan ise en fazla {limit} karakter okuyor. Kısaltıp yeniden çalıştırın.",
     "examplesTitle": "Neler isteyebilirsiniz",
     "showOnBoard": "Panoda göster",
     "declined": "Asistanın hiçbir eylemi bu istekle eşleşmiyor. İki servis arasında bağımlılık tanımlayabilir, bir depo adresinden servis ekleyebilir ya da bir izleyici kaydından görev oluşturabilir.",

package/i18n/locales/uk.json

@@ -1051,6 +1051,16 @@
       "configNoun": "конфіденційні тестові облікові дані",
       "duplicateKey": "Кожна назва змінної має бути унікальною."
     },
+    "testingContext": {
+      "title": "Контекст тестування",
+      "sectionHint": "Довільні нотатки про те, як тестують цю службу: які сценарії важливі, які тестові облікові записи існують і як під ними увійти, що означають наповнені дані та чого не чіпати. Кожен запуск Тестувальника для цієї служби отримує цей текст дослівно, так само як і пробний запуск середовища.",
+      "notSecret": "Цей текст потрапляє просто в підказку Тестувальника, тож не пишіть тут справжніх секретів. Зберігайте їх вище, у «Тестових облікових даних», а тут посилайтеся лише на назву змінної.",
+      "placeholder": "напр. увійдіть як $DEMO_USER; наповнений орендар: Acme з трьома проєктами; ніколи не запускайте сценарій оплати, він списує кошти зі справжньої картки.",
+      "length": "{count} з {max} символів",
+      "save": "Зберегти контекст тестування",
+      "revert": "Скасувати зміни",
+      "savedToast": "Контекст тестування збережено"
+    },
     "testConfig": {
       "title": "Тестова інфраструктура",
       "hint": "Як розгортається тестове середовище для цього сервісу, коли конвеєру потрібно його запустити: без інфраструктури, файл Docker Compose, маніфести Kubernetes або власний тип маніфесту.",
@@ -5031,9 +5041,13 @@
     "title": "Асистент",
     "intro": "Опишіть, що потрібно зробити, і асистент виконає це на дошці: оголосить залежність між двома сервісами, додасть сервіс за адресою репозиторію або створить завдання з тікета трекера.",
     "unavailable": "У цьому розгортанні не налаштовано жодної моделі, тому асистент не може прочитати запит. Налаштуйте постачальника моделей, щоб увімкнути його.",
+    "reading": "Перевіряємо, що асистент може зробити тут…",
+    "unreadable": "Не вдалося перевірити, що асистент може зробити тут, тож поле запиту поки приховано. Спробуйте ще раз за мить.",
+    "noActions": "Для асистента в цьому розгортанні не налаштовано жодної дії, тому він не може нічого виконати. Налаштуйте його дії, щоб увімкнути його.",
     "placeholder": "напр. сервіс checkout залежить від сервісу платежів",
     "submit": "Виконати",
     "submitHint": "Ctrl+Enter, на Mac Cmd+Enter",
+    "tooLong": "Цей запит містить {length} символів, а асистент читає щонайбільше {limit}. Скоротіть його та запустіть знову.",
     "examplesTitle": "Про що можна попросити",
     "showOnBoard": "Показати на дошці",
     "declined": "Жодна дія асистента не відповідає цьому запиту. Він може оголосити залежність між двома сервісами, додати сервіс за адресою репозиторію або створити завдання з тікета трекера.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.300.1",
+  "version": "0.301.0",
   "description": "Reusable Nuxt layer for the Agent Architecture Board SPA (components, stores, composables, pages). Consume it from a thin deployment app via `extends: ['@cat-factory/app']` and point it at your backend with NUXT_PUBLIC_API_BASE. See deploy/frontend for an example.",
   "repository": {
     "type": "git",
@@ -18,7 +18,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@cat-factory/contracts": "0.351.0",
+    "@cat-factory/contracts": "0.352.0",
     "@modular-frontend/core": "0.6.0",
     "@modular-vue/core": "^1.5.0",
     "@modular-vue/journeys": "^1.4.0",