@cat-factory/app 0.279.0 → 0.280.0

package/app/components/sandbox/SandboxPanel.vue

@@ -13,6 +13,7 @@ import type {
   SandboxPromptOrigin,
   SandboxPromptVersion,
   SandboxRun,
+  SandboxUnsupportedReason,
 } from '~/types/sandbox'
 
 const ui = useUiStore()
@@ -34,9 +35,21 @@ const FIXTURE_KIND_LABEL = computed<Record<SandboxFixtureKind, string>>(() => ({
   clarity: t('sandbox.fixtureKind.clarity'),
   architecture: t('sandbox.fixtureKind.architecture'),
   'code-review': t('sandbox.fixtureKind.code-review'),
+  estimation: t('sandbox.fixtureKind.estimation'),
+  'answer-recommendation': t('sandbox.fixtureKind.answer-recommendation'),
   'repo-feature': t('sandbox.fixtureKind.repo-feature'),
   'repo-bug': t('sandbox.fixtureKind.repo-bug'),
 }))
+/**
+ * Why the Sandbox cannot run a kind, in the reader's own language.
+ *
+ * The backend sends the CODE and this maps it: the catalog decides, the SPA words it. Composing
+ * the sentence server-side would have put untranslated English under a translated form label, and
+ * an exhaustive Record is what stops a new code shipping that way silently.
+ */
+const UNSUPPORTED_REASON_LABEL = computed<Record<SandboxUnsupportedReason, string>>(() => ({
+  'container-run-required': t('sandbox.unsupportedReason.container-run-required'),
+}))
 /**
  * Badge colour per prompt origin. An exhaustive Record over the closed union rather than a
  * ternary, so adding an origin fails the typecheck here instead of silently rendering as
@@ -99,6 +112,19 @@ watch(
 )
 
 // ---- experiment builder ----------------------------------------------------
+/**
+ * The kinds the builder may offer, and the ones it cannot, from the catalog's own answer.
+ *
+ * Offering an un-runnable kind is worse than omitting it: `POST /sandbox/experiments` refuses it, so
+ * the whole matrix is built and then 400s. But omitting it silently would read as "the Sandbox does
+ * not know about the coder", so the excluded kinds are NAMED with the catalog's own reason under the
+ * field. Their prompts stay in the Prompts tab, where cloning and promoting them still works.
+ */
+const runnableAgentKinds = computed(() => store.agentKinds.filter((k) => k.sandboxRun === 'inline'))
+const unrunnableAgentKinds = computed(() =>
+  store.agentKinds.filter((k) => k.sandboxRun !== 'inline'),
+)
+
 const agentKind = ref('requirements-review')
 const name = ref('')
 const selectedPromptIds = ref<string[]>([])
@@ -298,10 +324,22 @@ async function archive(prompt: SandboxPromptVersion) {
             <UFormField :label="t('sandbox.builder.agent')">
               <USelect
                 v-model="agentKind"
-                :items="store.agentKinds.map((k) => ({ label: k.label, value: k.agentKind }))"
+                :items="runnableAgentKinds.map((k) => ({ label: k.label, value: k.agentKind }))"
                 value-key="value"
                 class="w-full"
               />
+              <p
+                v-for="excluded in unrunnableAgentKinds"
+                :key="excluded.agentKind"
+                class="mt-1 text-[11px] leading-snug text-slate-500"
+              >
+                <span class="font-medium text-slate-400">{{ excluded.label }}:</span>
+                {{
+                  excluded.unsupportedReason
+                    ? UNSUPPORTED_REASON_LABEL[excluded.unsupportedReason]
+                    : t('sandbox.unsupportedReason.unknown')
+                }}
+              </p>
             </UFormField>
 
             <div>

package/app/types/sandbox.ts

@@ -5,10 +5,16 @@
 //
 // All wire shapes are sourced from @cat-factory/contracts (single source of truth).
 // The overview / agent-kind-meta / experiment-detail composites have no exported
-// contract type (the routes model them inline), so they stay frontend-only below —
-// and follow the contract's looser `string` for `bucket`/`rubric`.
+// contract type (the routes model them inline), so they stay frontend-only below.
+// `bucket`, `sandboxRun` and `unsupportedReason` reuse the contract's picklist types (the builder
+// branches on `sandboxRun` and MAPS `unsupportedReason` to a locale key, so a widened `string`
+// there would let a typo compile and a new member ship untranslated); `rubric` stays the
+// contract's looser `string`, since nothing here branches on it.
 
 export type {
+  SandboxAgentBucket,
+  SandboxRunMode,
+  SandboxUnsupportedReason,
   SandboxPromptOrigin,
   SandboxPromptVersion,
   SandboxFixtureKind,
@@ -30,19 +36,35 @@ export type {
 } from '@cat-factory/contracts'
 
 import type {
+  SandboxAgentBucket,
   SandboxExperiment,
   SandboxFixture,
   SandboxFixtureKind,
   SandboxGrade,
   SandboxPromptVersion,
   SandboxRun,
+  SandboxRunMode,
+  SandboxUnsupportedReason,
 } from '@cat-factory/contracts'
 
 /** The Sandbox catalog entry for a testable agent kind (from the overview). Frontend-only. */
 export interface SandboxAgentKindMeta {
   agentKind: string
   label: string
-  bucket: string
+  /** How PRODUCTION dispatches the kind (an inline call, or a container with a checkout). */
+  bucket: SandboxAgentBucket
+  /**
+   * How the SANDBOX runs a cell for it. `unsupported` ⇒ the builder must not offer it: creating an
+   * experiment for such a kind is refused server-side, so an enabled option would only ever produce
+   * a 400 on a surface that suggested it.
+   */
+  sandboxRun: SandboxRunMode
+  /**
+   * Why the Sandbox cannot run this kind, as the catalog's bounded CODE; null when it can. The
+   * builder maps it through an exhaustive `Record` to a locale key, so a new member fails the
+   * typecheck instead of reaching a non-English reader in English.
+   */
+  unsupportedReason: SandboxUnsupportedReason | null
   rubric: string
   /** Fixture kinds this agent is exercised against (the UI filters the library by these). */
   fixtureKinds: SandboxFixtureKind[]

package/i18n/locales/de.json

@@ -7021,9 +7021,15 @@
       "clarity": "Klarheit",
       "architecture": "Architektur",
       "code-review": "Code-Review",
+      "estimation": "Schätzung",
+      "answer-recommendation": "empfohlene Antworten",
       "repo-feature": "Repo-Feature",
       "repo-bug": "Repo-Bug"
     },
+    "unsupportedReason": {
+      "container-run-required": "Sein Ergebnis ist ein gepushter Commit. Die Bewertung braucht daher einen echten Container-Lauf gegen ein Seed-Repository; eine Inline-Zelle kann nur Text bewerten.",
+      "unknown": "Dieser Agent kann nicht in der Sandbox laufen."
+    },
     "fixtureOrigin": {
       "builtin": "integriert",
       "custom": "benutzerdefiniert"

package/i18n/locales/en.json

@@ -7098,9 +7098,15 @@
       "clarity": "clarity",
       "architecture": "architecture",
       "code-review": "code review",
+      "estimation": "estimation",
+      "answer-recommendation": "recommended answers",
       "repo-feature": "repo feature",
       "repo-bug": "repo bug"
     },
+    "unsupportedReason": {
+      "container-run-required": "Its deliverable is a pushed commit, so grading it needs a real container run against a seed repository. An inline cell can only grade text.",
+      "unknown": "This agent cannot run in the Sandbox."
+    },
     "fixtureOrigin": {
       "builtin": "builtin",
       "custom": "custom"

package/i18n/locales/es.json

@@ -6778,9 +6778,15 @@
       "clarity": "claridad",
       "architecture": "arquitectura",
       "code-review": "revisión de código",
+      "estimation": "estimación",
+      "answer-recommendation": "respuestas recomendadas",
       "repo-feature": "función de repositorio",
       "repo-bug": "error de repositorio"
     },
+    "unsupportedReason": {
+      "container-run-required": "Su entregable es un commit publicado, así que evaluarlo requiere una ejecución real en contenedor contra un repositorio semilla; una celda en línea solo puede evaluar texto.",
+      "unknown": "Este agente no puede ejecutarse en el Sandbox."
+    },
     "fixtureOrigin": {
       "builtin": "integrado",
       "custom": "personalizado"

package/i18n/locales/fr.json

@@ -6778,9 +6778,15 @@
       "clarity": "clarté",
       "architecture": "architecture",
       "code-review": "revue de code",
+      "estimation": "estimation",
+      "answer-recommendation": "réponses recommandées",
       "repo-feature": "fonctionnalité de dépôt",
       "repo-bug": "bogue de dépôt"
     },
+    "unsupportedReason": {
+      "container-run-required": "Son livrable est un commit poussé : l’évaluer exige une exécution réelle en conteneur sur un dépôt de départ ; une cellule en ligne ne peut évaluer que du texte.",
+      "unknown": "Cet agent ne peut pas s’exécuter dans le Sandbox."
+    },
     "fixtureOrigin": {
       "builtin": "intégré",
       "custom": "personnalisé"

package/i18n/locales/he.json

@@ -6778,9 +6778,15 @@
       "clarity": "בהירות",
       "architecture": "ארכיטקטורה",
       "code-review": "סקירת קוד",
+      "estimation": "אמדן",
+      "answer-recommendation": "תשובות מומלצות",
       "repo-feature": "פיצ׳ר במאגר",
       "repo-bug": "באג במאגר"
     },
+    "unsupportedReason": {
+      "container-run-required": "התוצר שלו הוא קומיט שנדחף, ולכן הערכה שלו דורשת הרצה אמיתית בקונטיינר מול מאגר זרע; תא מוטבע יכול להעריך טקסט בלבד.",
+      "unknown": "סוכן זה אינו יכול לרוץ ב-Sandbox."
+    },
     "fixtureOrigin": {
       "builtin": "מובנה",
       "custom": "מותאם אישית"

package/i18n/locales/it.json

@@ -7021,9 +7021,15 @@
       "clarity": "chiarezza",
       "architecture": "architettura",
       "code-review": "revisione del codice",
+      "estimation": "stima",
+      "answer-recommendation": "risposte consigliate",
       "repo-feature": "funzionalità del repository",
       "repo-bug": "bug del repository"
     },
+    "unsupportedReason": {
+      "container-run-required": "Il suo risultato è un commit inviato, quindi valutarlo richiede un’esecuzione reale in container su un repository seme; una cella inline può valutare solo testo.",
+      "unknown": "Questo agente non può essere eseguito nella Sandbox."
+    },
     "fixtureOrigin": {
       "builtin": "integrata",
       "custom": "personalizzata"

package/i18n/locales/ja.json

@@ -6778,9 +6778,15 @@
       "clarity": "明確さ",
       "architecture": "アーキテクチャ",
       "code-review": "コードレビュー",
+      "estimation": "見積もり",
+      "answer-recommendation": "推奨回答",
       "repo-feature": "リポジトリ機能",
       "repo-bug": "リポジトリのバグ"
     },
+    "unsupportedReason": {
+      "container-run-required": "成果物はプッシュされたコミットのため、評価にはシード用リポジトリに対する実際のコンテナ実行が必要です。インラインのセルはテキストしか評価できません。",
+      "unknown": "このエージェントはサンドボックスでは実行できません。"
+    },
     "fixtureOrigin": {
       "builtin": "組み込み",
       "custom": "カスタム"

package/i18n/locales/pl.json

@@ -6778,9 +6778,15 @@
       "clarity": "klarowność",
       "architecture": "architektura",
       "code-review": "przegląd kodu",
+      "estimation": "szacowanie",
+      "answer-recommendation": "rekomendowane odpowiedzi",
       "repo-feature": "funkcja repozytorium",
       "repo-bug": "błąd repozytorium"
     },
+    "unsupportedReason": {
+      "container-run-required": "Jego wynikiem jest wypchnięty commit, więc ocena wymaga prawdziwego uruchomienia w kontenerze na repozytorium zalążkowym; komórka inline potrafi ocenić wyłącznie tekst.",
+      "unknown": "Ten agent nie może działać w Sandboksie."
+    },
     "fixtureOrigin": {
       "builtin": "wbudowany",
       "custom": "niestandardowy"

package/i18n/locales/tr.json

@@ -6778,9 +6778,15 @@
       "clarity": "netlik",
       "architecture": "mimari",
       "code-review": "kod incelemesi",
+      "estimation": "tahmin",
+      "answer-recommendation": "önerilen yanıtlar",
       "repo-feature": "depo özelliği",
       "repo-bug": "depo hatası"
     },
+    "unsupportedReason": {
+      "container-run-required": "Çıktısı gönderilmiş bir commit olduğundan değerlendirilmesi, bir tohum deposu üzerinde gerçek bir konteyner çalıştırması gerektirir; satır içi hücre yalnızca metni değerlendirebilir.",
+      "unknown": "Bu ajan Sandbox’ta çalıştırılamaz."
+    },
     "fixtureOrigin": {
       "builtin": "yerleşik",
       "custom": "özel"

package/i18n/locales/uk.json

@@ -6778,9 +6778,15 @@
       "clarity": "ясність",
       "architecture": "архітектура",
       "code-review": "огляд коду",
+      "estimation": "оцінювання",
+      "answer-recommendation": "рекомендовані відповіді",
       "repo-feature": "функція репозиторію",
       "repo-bug": "помилка репозиторію"
     },
+    "unsupportedReason": {
+      "container-run-required": "Його результатом є надісланий коміт, тож оцінювання потребує справжнього запуску в контейнері на репозиторії-заготовці; вбудована комірка може оцінювати лише текст.",
+      "unknown": "Цей агент не може працювати в Sandbox."
+    },
     "fixtureOrigin": {
       "builtin": "вбудована",
       "custom": "користувацька"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.279.0",
+  "version": "0.280.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",
@@ -40,7 +40,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.41",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.319.0"
+    "@cat-factory/contracts": "0.320.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",