@cat-factory/app 0.154.0 → 0.154.1

package/app/components/panels/inspector/ServiceTestConfig.vue

@@ -255,7 +255,15 @@ async function generateOrFixManifest() {
 // it failed at. The returned run is tracked live (by frame id) via the workspace stream store.
 const envTest = useEnvironmentTestStore()
 const envTestStarting = ref(false)
-const envTestError = ref<string | null>(null)
+// The self-test's start/stop error. Structured (not a bare string) so the not-provisionable case
+// can render its remedy prose PLUS a one-click jump to the environment-handler config; every other
+// case is plain text.
+interface EnvTestError {
+  text: string
+  /** Show the "Configure infrastructure" deep-link — only the not-provisionable handler case. */
+  configurable?: boolean
+}
+const envTestError = ref<EnvTestError | null>(null)
 // The newest self-test run for this frame — re-attaches after a reconnect (the run is carried in
 // the snapshot while running), so the live stage keeps showing without a locally-held id.
 const envTestRun = computed(() => envTest.runForBlock(props.block.id))
@@ -291,14 +299,30 @@ const ENV_TEST_CONFLICT_KEYS: Record<Extract<ConflictReason, `env_test_${string}
   env_test_no_vcs: 'errors.conflict.title.env_test_no_vcs',
 }
 
-function envTestErrorText(e: unknown): string {
-  const reason = parseConflict(e)?.reason
+function buildEnvTestError(e: unknown): EnvTestError {
+  const parsed = parseConflict(e)
+  const reason = parsed?.reason
+  // No workspace handler resolves for the service's provision type. Word the SPECIFIC case —
+  // nothing configured vs. an ambiguous match (carried on `details.handlerIssue`, distinct from the
+  // `env_test_not_provisionable` code) — and offer the one-click jump to the Infrastructure →
+  // Test-environments handler config.
+  if (reason === 'env_test_not_provisionable') {
+    const ambiguous = parsed?.details.handlerIssue === 'type-mismatch'
+    return {
+      text: t(
+        ambiguous
+          ? 'errors.conflict.description.env_test_not_provisionable_type_mismatch'
+          : 'errors.conflict.description.env_test_not_provisionable_no_handler',
+      ),
+      configurable: true,
+    }
+  }
   const key =
     reason && reason in ENV_TEST_CONFLICT_KEYS
       ? ENV_TEST_CONFLICT_KEYS[reason as keyof typeof ENV_TEST_CONFLICT_KEYS]
       : undefined
-  if (key && te(key)) return t(key)
-  return apiErrorEnvelope(e)?.message ?? (e instanceof Error ? e.message : String(e))
+  if (key && te(key)) return { text: t(key) }
+  return { text: apiErrorEnvelope(e)?.message ?? (e instanceof Error ? e.message : String(e)) }
 }
 
 async function startEnvTest() {
@@ -308,7 +332,7 @@ async function startEnvTest() {
   try {
     await envTest.start(props.block.id)
   } catch (e) {
-    envTestError.value = envTestErrorText(e)
+    envTestError.value = buildEnvTestError(e)
   } finally {
     envTestStarting.value = false
   }
@@ -320,7 +344,7 @@ async function stopEnvTest() {
   try {
     await envTest.stop(run.id)
   } catch (e) {
-    envTestError.value = envTestErrorText(e)
+    envTestError.value = buildEnvTestError(e)
   }
 }
 
@@ -1072,9 +1096,23 @@ function setSize(value: InstanceSize) {
         </template>
       </p>
 
-      <p v-if="envTestError" class="text-[11px] text-rose-400" data-testid="env-test-error">
-        {{ envTestError }}
-      </p>
+      <div v-if="envTestError" class="text-[11px] text-rose-400" data-testid="env-test-error">
+        <p>{{ envTestError.text }}</p>
+        <!-- Only the not-provisionable handler case is one-click fixable: jump to Infrastructure →
+             Test environments, where the workspace's per-type environment handler is registered. -->
+        <UButton
+          v-if="envTestError.configurable"
+          class="mt-1.5"
+          icon="i-lucide-settings"
+          size="xs"
+          color="neutral"
+          variant="soft"
+          data-testid="env-test-configure-handler"
+          @click="ui.openProviderConnection('environment')"
+        >
+          {{ t('errors.conflict.action.configureInfrastructure') }}
+        </UButton>
+      </div>
     </div>
   </InspectorSection>
 </template>

package/app/components/settings/ApiTokensPanel.vue

@@ -11,10 +11,12 @@ import CopyButton from '~/components/common/CopyButton.vue'
 
 const { t, d } = useI18n()
 
-// The permission ladder a minted key can carry (read ⊂ write ⊂ admin), mirroring the backend
-// contract. A `read` key can only observe; `write` adds create/start/manage; `admin` adds the
-// destructive/merge-adjacent operations (e.g. deleting a task).
-const SCOPES: PublicApiScope[] = ['read', 'write', 'admin']
+// The permission ladder a minted key can carry (read ⊂ write ⊂ decide ⊂ admin), mirroring the
+// backend contract. A `read` key can only observe; `write` adds create/start/manage; `decide` adds
+// answering a run's PARKED human decisions (and, because of that, starting a headless run on a
+// pipeline that can park at all); `admin` adds the destructive/merge-adjacent operations (e.g.
+// deleting a task).
+const SCOPES: PublicApiScope[] = ['read', 'write', 'decide', 'admin']
 
 /** Localized label for a scope — an exhaustive switch, so a new scope is a compile error here. */
 function scopeLabel(scope: PublicApiScope): string {
@@ -23,6 +25,8 @@ function scopeLabel(scope: PublicApiScope): string {
       return t('settings.apiTokens.scopes.read')
     case 'write':
       return t('settings.apiTokens.scopes.write')
+    case 'decide':
+      return t('settings.apiTokens.scopes.decide')
     case 'admin':
       return t('settings.apiTokens.scopes.admin')
   }

package/i18n/locales/de.json

@@ -550,6 +550,7 @@
       "scopes": {
         "read": "Nur Lesen",
         "write": "Lesen und Schreiben",
+        "decide": "Antworten auf Entscheidungen",
         "admin": "Vollzugriff"
       },
       "toast": {
@@ -4137,6 +4138,8 @@
         "env_test_not_a_frame": "Der Umgebungs-Selbsttest läuft pro Service und kann daher nur für einen Service gestartet werden, nicht für ein Modul oder eine Aufgabe.",
         "env_test_infraless": "Für diesen Service ist keine Bereitstellung einer kurzlebigen Umgebung konfiguriert, es gibt also nichts, was der Selbsttest prüfen könnte.",
         "env_test_not_provisionable": "Dieser Service hat einen Bereitstellungstyp, aber es ist noch kein Workspace-Handler dafür verfügbar, sodass die Bereitstellung nicht laufen kann. Konfiguriere einen Umgebungs-Handler.",
+        "env_test_not_provisionable_no_handler": "Für den Bereitstellungstyp dieses Service ist kein Workspace-Umgebungs-Handler konfiguriert. Registriere in Infrastruktur → Testumgebungen einen — für einen benutzerdefinierten Anbieter einen Custom (remote-custom)-Handler, dessen akzeptierte manifest id mit der übereinstimmt, die dieser Service festlegt.",
+        "env_test_not_provisionable_type_mismatch": "Mehr als ein Umgebungs-Handler könnte auf den Bereitstellungstyp dieses Service passen. Lege für diesen Service eine manifest id fest, sodass genau einer aufgelöst wird, oder entferne den überlappenden Handler in Infrastruktur → Testumgebungen.",
         "env_test_no_vcs": "Der Selbsttest benötigt einen Git-Anbieter, um seinen Wegwerf-Branch zu erstellen und zu löschen, aber dieser Workspace ist mit keinem verbunden."
       },
       "action": {

package/i18n/locales/en.json

@@ -554,6 +554,8 @@
         "env_test_not_a_frame": "The environment self-test runs per service, so it can only be started on a service, not on a module or task.",
         "env_test_infraless": "This service has no ephemeral-environment provisioning configured, so there is nothing for the self-test to exercise.",
         "env_test_not_provisionable": "This service has a provision type, but no workspace handler resolves for it yet, so provisioning can't run. Configure an environment handler.",
+        "env_test_not_provisionable_no_handler": "No workspace environment handler is configured for this service's provision type. In Infrastructure → Test environments, register one — for a custom provider, a Custom (remote-custom) handler whose accepted manifest id matches the one this service pins.",
+        "env_test_not_provisionable_type_mismatch": "More than one environment handler could match this service's provision type. Pin a manifest id for this service so exactly one resolves, or remove the overlapping handler in Infrastructure → Test environments.",
         "env_test_no_vcs": "The self-test needs a git provider to create and delete its throwaway branch, but this workspace isn't connected to one."
       },
       "action": {
@@ -2585,6 +2587,7 @@
       "scopes": {
         "read": "Read only",
         "write": "Read and write",
+        "decide": "Answer decisions",
         "admin": "Full access"
       },
       "toast": {

package/i18n/locales/es.json

@@ -512,6 +512,8 @@
         "env_test_not_a_frame": "La autoprueba de entorno se ejecuta por servicio, así que solo puede iniciarse en un servicio, no en un módulo o una tarea.",
         "env_test_infraless": "Este servicio no tiene configurado el aprovisionamiento de entornos efímeros, así que no hay nada que la autoprueba pueda comprobar.",
         "env_test_not_provisionable": "Este servicio tiene un tipo de aprovisionamiento, pero aún no hay ningún gestor del espacio de trabajo para él, así que el aprovisionamiento no puede ejecutarse. Configura un gestor de entornos.",
+        "env_test_not_provisionable_no_handler": "No hay ningún gestor de entorno del espacio de trabajo configurado para el tipo de aprovisionamiento de este servicio. En Infraestructura → Entornos de prueba, registra uno; para un proveedor personalizado, un gestor Custom (remote-custom) cuyo manifest id aceptado coincida con el que fija este servicio.",
+        "env_test_not_provisionable_type_mismatch": "Más de un gestor de entorno podría coincidir con el tipo de aprovisionamiento de este servicio. Fija un manifest id para este servicio de modo que se resuelva exactamente uno, o elimina el gestor superpuesto en Infraestructura → Entornos de prueba.",
         "env_test_no_vcs": "La autoprueba necesita un proveedor de Git para crear y eliminar su rama desechable, pero este espacio de trabajo no está conectado a ninguno."
       },
       "action": {
@@ -2397,6 +2399,7 @@
       "scopes": {
         "read": "Solo lectura",
         "write": "Lectura y escritura",
+        "decide": "Responder decisiones",
         "admin": "Acceso completo"
       },
       "toast": {

package/i18n/locales/fr.json

@@ -512,6 +512,8 @@
         "env_test_not_a_frame": "L'auto-test d'environnement s'exécute par service, il ne peut donc être lancé que sur un service, pas sur un module ou une tâche.",
         "env_test_infraless": "Ce service n'a aucun provisionnement d'environnement éphémère configuré, il n'y a donc rien que l'auto-test puisse exercer.",
         "env_test_not_provisionable": "Ce service a un type de provisionnement, mais aucun gestionnaire de l'espace de travail ne s'y applique encore, le provisionnement ne peut donc pas s'exécuter. Configurez un gestionnaire d'environnement.",
+        "env_test_not_provisionable_no_handler": "Aucun gestionnaire d'environnement de l'espace de travail n'est configuré pour le type de provisionnement de ce service. Dans Infrastructure → Environnements de test, enregistrez-en un — pour un fournisseur personnalisé, un gestionnaire Custom (remote-custom) dont le manifest id accepté correspond à celui que ce service épingle.",
+        "env_test_not_provisionable_type_mismatch": "Plusieurs gestionnaires d'environnement pourraient correspondre au type de provisionnement de ce service. Épinglez un manifest id pour ce service afin qu'un seul se résolve, ou supprimez le gestionnaire qui se chevauche dans Infrastructure → Environnements de test.",
         "env_test_no_vcs": "L'auto-test a besoin d'un fournisseur Git pour créer et supprimer sa branche jetable, mais cet espace de travail n'est connecté à aucun."
       },
       "action": {
@@ -2397,6 +2399,7 @@
       "scopes": {
         "read": "Lecture seule",
         "write": "Lecture et écriture",
+        "decide": "Répondre aux décisions",
         "admin": "Accès complet"
       },
       "toast": {

package/i18n/locales/he.json

@@ -512,6 +512,8 @@
         "env_test_not_a_frame": "הבדיקה העצמית של הסביבה רצה לכל שירות בנפרד, ולכן ניתן להתחיל אותה רק על שירות, לא על מודול או משימה.",
         "env_test_infraless": "לשירות זה לא מוגדרת הקצאת סביבה זמנית, ולכן אין מה שהבדיקה העצמית תבדוק.",
         "env_test_not_provisionable": "לשירות זה יש סוג הקצאה, אך עדיין אין עבורו מטפל בסביבת העבודה, ולכן ההקצאה אינה יכולה לרוץ. הגדר מטפל סביבה.",
+        "env_test_not_provisionable_no_handler": "לא מוגדר מטפל סביבה של סביבת העבודה עבור סוג ההקצאה של שירות זה. בתשתית → סביבות בדיקה, רשום אחד — עבור ספק מותאם אישית, מטפל Custom (remote-custom) שה-manifest id המקובל שלו תואם לזה ששירות זה מקבע.",
+        "env_test_not_provisionable_type_mismatch": "יותר ממטפל סביבה אחד יכול להתאים לסוג ההקצאה של שירות זה. קבע manifest id עבור שירות זה כך שרק אחד ייפתר, או הסר את המטפל החופף בתשתית → סביבות בדיקה.",
         "env_test_no_vcs": "הבדיקה העצמית זקוקה לספק Git כדי ליצור ולמחוק את הענף החד-פעמי שלה, אך סביבת עבודה זו אינה מחוברת לאף אחד."
       },
       "action": {
@@ -2518,6 +2520,7 @@
       "scopes": {
         "read": "קריאה בלבד",
         "write": "קריאה וכתיבה",
+        "decide": "מענה להחלטות",
         "admin": "גישה מלאה"
       },
       "toast": {

package/i18n/locales/it.json

@@ -550,6 +550,7 @@
       "scopes": {
         "read": "Sola lettura",
         "write": "Lettura e scrittura",
+        "decide": "Rispondere alle decisioni",
         "admin": "Accesso completo"
       },
       "toast": {
@@ -4137,6 +4138,8 @@
         "env_test_not_a_frame": "L'autotest dell'ambiente viene eseguito per servizio, quindi può essere avviato solo su un servizio, non su un modulo o un'attività.",
         "env_test_infraless": "Questo servizio non ha alcun provisioning di ambiente effimero configurato, quindi non c'è nulla che l'autotest possa verificare.",
         "env_test_not_provisionable": "Questo servizio ha un tipo di provisioning, ma non è ancora disponibile alcun handler del workspace, quindi il provisioning non può essere eseguito. Configura un handler dell'ambiente.",
+        "env_test_not_provisionable_no_handler": "Nessun handler dell'ambiente del workspace è configurato per il tipo di provisioning di questo servizio. In Infrastruttura → Ambienti di test, registrane uno — per un provider personalizzato, un handler Custom (remote-custom) il cui manifest id accettato corrisponde a quello che questo servizio fissa.",
+        "env_test_not_provisionable_type_mismatch": "Più di un handler dell'ambiente potrebbe corrispondere al tipo di provisioning di questo servizio. Fissa un manifest id per questo servizio in modo che se ne risolva esattamente uno, oppure rimuovi l'handler sovrapposto in Infrastruttura → Ambienti di test.",
         "env_test_no_vcs": "L'autotest ha bisogno di un provider Git per creare ed eliminare il suo branch usa e getta, ma questo workspace non è collegato a nessuno."
       },
       "action": {

package/i18n/locales/ja.json

@@ -512,6 +512,8 @@
         "env_test_not_a_frame": "環境のセルフテストはサービスごとに実行されるため、モジュールやタスクではなくサービスでのみ開始できます。",
         "env_test_infraless": "このサービスには一時環境のプロビジョニングが設定されていないため、セルフテストで検証するものがありません。",
         "env_test_not_provisionable": "このサービスにはプロビジョニングタイプがありますが、対応するワークスペースハンドラーがまだ解決されないため、プロビジョニングを実行できません。環境ハンドラーを設定してください。",
+        "env_test_not_provisionable_no_handler": "このサービスのプロビジョニングタイプに対して、ワークスペースの環境ハンドラーが設定されていません。インフラストラクチャ → テスト環境 で 1 つ登録してください。カスタムプロバイダーの場合は、受け入れる manifest id がこのサービスが固定するものと一致する Custom (remote-custom) ハンドラーを登録します。",
+        "env_test_not_provisionable_type_mismatch": "複数の環境ハンドラーがこのサービスのプロビジョニングタイプに一致する可能性があります。ちょうど 1 つだけが解決されるように、このサービスに manifest id を固定するか、インフラストラクチャ → テスト環境 で重複するハンドラーを削除してください。",
         "env_test_no_vcs": "セルフテストは使い捨てブランチの作成と削除のために Git プロバイダーを必要としますが、このワークスペースはいずれにも接続されていません。"
       },
       "action": {
@@ -2519,6 +2521,7 @@
       "scopes": {
         "read": "読み取り専用",
         "write": "読み取りと書き込み",
+        "decide": "判断への回答",
         "admin": "フルアクセス"
       },
       "toast": {

package/i18n/locales/pl.json

@@ -512,6 +512,8 @@
         "env_test_not_a_frame": "Autotest środowiska działa dla poszczególnych usług, więc można go uruchomić tylko dla usługi, a nie dla modułu czy zadania.",
         "env_test_infraless": "Ta usługa nie ma skonfigurowanego udostępniania środowisk tymczasowych, więc autotest nie ma czego sprawdzić.",
         "env_test_not_provisionable": "Ta usługa ma typ udostępniania, ale nie ma jeszcze dla niego żadnego mechanizmu obsługi w przestrzeni roboczej, więc udostępnianie nie może zostać uruchomione. Skonfiguruj mechanizm obsługi środowiska.",
+        "env_test_not_provisionable_no_handler": "Dla typu udostępniania tej usługi nie skonfigurowano żadnego mechanizmu obsługi środowiska w przestrzeni roboczej. W sekcji Infrastruktura → Środowiska testowe zarejestruj jeden — dla dostawcy niestandardowego mechanizm obsługi Custom (remote-custom), którego akceptowany manifest id odpowiada temu, który przypina ta usługa.",
+        "env_test_not_provisionable_type_mismatch": "Do typu udostępniania tej usługi może pasować więcej niż jeden mechanizm obsługi środowiska. Przypnij manifest id do tej usługi, aby rozwiązywany był dokładnie jeden, albo usuń nakładający się mechanizm obsługi w sekcji Infrastruktura → Środowiska testowe.",
         "env_test_no_vcs": "Autotest potrzebuje dostawcy Git, aby utworzyć i usunąć swoją jednorazową gałąź, ale ta przestrzeń robocza nie jest połączona z żadnym."
       },
       "action": {
@@ -2397,6 +2399,7 @@
       "scopes": {
         "read": "Tylko odczyt",
         "write": "Odczyt i zapis",
+        "decide": "Odpowiadanie na decyzje",
         "admin": "Pełny dostęp"
       },
       "toast": {

package/i18n/locales/tr.json

@@ -512,6 +512,8 @@
         "env_test_not_a_frame": "Ortam öz testi hizmet başına çalışır, bu yüzden yalnızca bir hizmette başlatılabilir; bir modülde veya görevde değil.",
         "env_test_infraless": "Bu hizmet için yapılandırılmış geçici ortam sağlama yok, bu yüzden öz testin sınayacağı bir şey yok.",
         "env_test_not_provisionable": "Bu hizmetin bir sağlama türü var ancak henüz onun için çözümlenen bir çalışma alanı işleyicisi yok, bu yüzden sağlama çalışamaz. Bir ortam işleyicisi yapılandır.",
+        "env_test_not_provisionable_no_handler": "Bu hizmetin sağlama türü için yapılandırılmış bir çalışma alanı ortam işleyicisi yok. Altyapı → Test ortamları bölümünde bir tane kaydet — özel bir sağlayıcı için, kabul ettiği manifest id bu hizmetin sabitlediğiyle eşleşen bir Custom (remote-custom) işleyicisi.",
+        "env_test_not_provisionable_type_mismatch": "Birden fazla ortam işleyicisi bu hizmetin sağlama türüyle eşleşebilir. Tam olarak biri çözümlensin diye bu hizmet için bir manifest id sabitle ya da Altyapı → Test ortamları bölümündeki çakışan işleyiciyi kaldır.",
         "env_test_no_vcs": "Öz test, tek kullanımlık dalını oluşturup silmek için bir Git sağlayıcısına ihtiyaç duyar ancak bu çalışma alanı hiçbirine bağlı değil."
       },
       "action": {
@@ -2519,6 +2521,7 @@
       "scopes": {
         "read": "Yalnızca okuma",
         "write": "Okuma ve yazma",
+        "decide": "Kararları yanıtlama",
         "admin": "Tam erişim"
       },
       "toast": {

package/i18n/locales/uk.json

@@ -512,6 +512,8 @@
         "env_test_not_a_frame": "Самоперевірка середовища виконується для кожної служби, тож її можна запустити лише для служби, а не для модуля чи завдання.",
         "env_test_infraless": "Для цієї служби не налаштовано надання тимчасового середовища, тож самоперевірці нічого перевіряти.",
         "env_test_not_provisionable": "Ця служба має тип надання, але для нього ще немає обробника робочого простору, тож надання не може виконатися. Налаштуй обробник середовища.",
+        "env_test_not_provisionable_no_handler": "Для типу надання цієї служби не налаштовано жодного обробника середовища робочого простору. У розділі Інфраструктура → Тестові середовища зареєструй один — для власного постачальника обробник Custom (remote-custom), чий прийнятний manifest id збігається з тим, який закріплює ця служба.",
+        "env_test_not_provisionable_type_mismatch": "Типу надання цієї служби може відповідати більше ніж один обробник середовища. Закріпи manifest id для цієї служби, щоб розв'язувався рівно один, або вилучи обробник, що перекривається, у розділі Інфраструктура → Тестові середовища.",
         "env_test_no_vcs": "Самоперевірці потрібен постачальник Git, щоб створити та видалити свою тимчасову гілку, але цей робочий простір не під'єднано до жодного."
       },
       "action": {
@@ -2397,6 +2399,7 @@
       "scopes": {
         "read": "Лише читання",
         "write": "Читання та запис",
+        "decide": "Відповіді на рішення",
         "admin": "Повний доступ"
       },
       "toast": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.154.0",
+  "version": "0.154.1",
   "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",
@@ -40,7 +40,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.40",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.162.0"
+    "@cat-factory/contracts": "0.163.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",