@cat-factory/app 0.114.0 → 0.115.0

package/app/components/board/AgentFailureCard.vue

@@ -4,7 +4,7 @@
 // the unified retry through the agentRuns store, so every surface (board card,
 // inspector, task panel) gets identical behaviour from one place. Replaces the
 // three hand-rolled bootstrap banners that used to duplicate this logic.
-import type { EnvironmentFailureReason } from '@cat-factory/contracts'
+import type { ConflictReason, EnvironmentFailureReason } from '@cat-factory/contracts'
 import type { AgentRunSummary } from '~/stores/agentRuns'
 import FailureDetail from '~/components/board/FailureDetail.vue'
 
@@ -26,6 +26,10 @@ const failure = computed(() => props.run.failure)
 // infra-setup banners use.
 const isEnvironmentFailure = computed(() => failure.value?.kind === 'environment')
 const DEPLOY_RUNNER_UNWIRED: EnvironmentFailureReason = 'deploy_runner_unwired'
+// A `preflight` rejection with this reason means the run couldn't start because the workspace
+// has no connected/linked repo — the same cause the 409 toast words, so reuse its translated
+// title (and let the backend's actionable message + doc link show in the detail below).
+const GITHUB_NOT_CONNECTED: ConflictReason = 'github_not_connected'
 
 // The provision type of the failed run's SERVICE frame (walk up to the frame, mirroring the
 // backend's `resolveServiceProvisioning`). Drives the K8s-specific gate below.
@@ -69,6 +73,10 @@ const showEnvironmentLocalHint = computed(
     provisionType.value === 'kubernetes',
 )
 const title = computed(() => {
+  // A `github_not_connected` preflight rejection (no repo linked/connected) — name it with
+  // the same translated title the 409 toast uses, with the actionable remedy in the detail.
+  if (failure.value?.reason === GITHUB_NOT_CONNECTED)
+    return t('errors.conflict.title.github_not_connected')
   // A `dispatch` failure means the container/runner never accepted the job — say so
   // explicitly rather than the generic "Run failed", and show the verbatim provider
   // error in the collapsible detail below.

package/app/components/forkDecision/ForkDecisionWindow.vue

@@ -3,14 +3,16 @@
 // materially different implementation approaches, opened via the universal result-view host
 // (`ui.openForkDecision`). It reads the live fork state straight off the run's Coder step
 // (`step.forkDecision`, kept fresh by the execution stream) and lets a human pick a proposed
-// fork OR enter their own free-text approach. Once chosen, the Coder re-runs with the chosen
-// approach folded in. Chat is added in a later slice.
+// fork OR enter their own free-text approach, or CHAT about the forks before deciding. Once
+// chosen, the Coder re-runs with the chosen approach folded in. Chat replies are computed by an
+// inline grounded LLM in the durable driver and arrive live on the execution stream.
 import { computed, ref, watch } from 'vue'
+import { DEFAULT_FORK_MAX_CHAT_TURNS } from '@cat-factory/contracts'
 import { useResultView } from '~/composables/useResultView'
 import { useExecutionStore } from '~/stores/execution'
 import { useBoardStore } from '~/stores/board'
 import { useForkDecisionStore } from '~/stores/forkDecision'
-import type { ForkDecisionStepState, ForkOption } from '~/types/execution'
+import type { ForkChatMessage, ForkDecisionStepState, ForkOption } from '~/types/execution'
 import { FORK_DECISION_META } from '~/utils/catalog'
 
 const execution = useExecutionStore()
@@ -36,11 +38,25 @@ const state = computed<ForkDecisionStepState | null>(() => step.value?.forkDecis
 const status = computed(() => state.value?.status ?? null)
 const forks = computed<ForkOption[]>(() => state.value?.forks ?? [])
 const awaiting = computed(() => status.value === 'awaiting_choice')
+// A chat turn is being answered by the inline responder (the reply arrives via the stream).
+const answering = computed(() => status.value === 'answering')
+// The interactive surface (fork cards + chat + choose) is shown while awaiting OR answering.
+const interactive = computed(() => awaiting.value || answering.value)
+const chat = computed<ForkChatMessage[]>(() => state.value?.chat ?? [])
+// The chat has spent its human-turn budget once the human has sent `maxChatTurns` messages.
+const chatBudgetSpent = computed(() => {
+  const max = state.value?.maxChatTurns ?? DEFAULT_FORK_MAX_CHAT_TURNS
+  return chat.value.filter((m) => m.role === 'human').length >= max
+})
+// `awaiting` and `answering` are mutually exclusive statuses, so awaiting already implies the
+// chat isn't mid-answer — no separate `!answering` guard is needed.
+const canChat = computed(() => awaiting.value && !chatBudgetSpent.value && !forkDecision.chatting)
 
 // The human's selection: a proposed fork id, or the sentinel 'custom' for the free-text path.
 const selected = ref<string | null>(null)
 const customText = ref('')
 const note = ref('')
+const chatInput = ref('')
 
 // Default the selection to the recommended fork whenever the fork set changes.
 watch(
@@ -72,6 +88,14 @@ async function onChoose() {
       : { forkId: selected.value!, note: noteText }
   await forkDecision.choose(id, choice).catch(() => {})
 }
+
+async function onSend() {
+  const id = instanceId.value
+  const text = chatInput.value.trim()
+  if (!id || !text || !canChat.value) return
+  chatInput.value = ''
+  await forkDecision.chat(id, text).catch(() => {})
+}
 </script>
 
 <template>
@@ -157,8 +181,8 @@ async function onChoose() {
             </p>
           </div>
 
-          <!-- Awaiting the human's choice. -->
-          <div v-else-if="awaiting" class="space-y-3">
+          <!-- Awaiting the human's choice (or answering a chat turn). -->
+          <div v-else-if="interactive" class="space-y-3">
             <p
               v-if="forkDecision.error"
               class="rounded-md bg-rose-500/10 px-3 py-2 text-[12px] text-rose-300"
@@ -263,6 +287,74 @@ async function onChoose() {
                 class="w-full rounded-md border border-slate-700 bg-slate-950/60 px-2.5 py-1.5 text-[12px] text-slate-100 placeholder:text-slate-600 focus:border-violet-500 focus:outline-none"
               />
             </div>
+
+            <!-- Grounded chat: ask about the forks before deciding. -->
+            <section class="rounded-xl border border-slate-800 bg-slate-900/40 px-4 py-3">
+              <p class="text-[11px] font-medium text-slate-400">
+                {{ t('forkDecision.chat.title') }}
+              </p>
+              <div
+                v-if="chat.length || answering"
+                class="mt-2 max-h-64 space-y-2 overflow-y-auto pr-1"
+              >
+                <div
+                  v-for="msg in chat"
+                  :key="msg.id"
+                  data-testid="fork-chat-message"
+                  class="flex"
+                  :class="msg.role === 'human' ? 'justify-end' : 'justify-start'"
+                >
+                  <p
+                    class="max-w-[85%] whitespace-pre-wrap rounded-lg px-3 py-1.5 text-[12px]"
+                    :class="
+                      msg.role === 'human'
+                        ? 'bg-violet-500/15 text-violet-100'
+                        : 'bg-slate-800/70 text-slate-200'
+                    "
+                  >
+                    {{ msg.text }}
+                  </p>
+                </div>
+                <div v-if="answering" class="flex justify-start">
+                  <p
+                    class="flex items-center gap-1.5 rounded-lg bg-slate-800/70 px-3 py-1.5 text-[12px] text-slate-400"
+                  >
+                    <UIcon name="i-lucide-loader-circle" class="h-3.5 w-3.5 animate-spin" />
+                    {{ t('forkDecision.chat.thinking') }}
+                  </p>
+                </div>
+              </div>
+              <p v-else class="mt-1 text-[11px] text-slate-500">
+                {{ t('forkDecision.chat.hint') }}
+              </p>
+              <div class="mt-2 flex items-end gap-2">
+                <textarea
+                  v-model="chatInput"
+                  data-testid="fork-chat-input"
+                  rows="2"
+                  :disabled="!canChat"
+                  :placeholder="
+                    chatBudgetSpent
+                      ? t('forkDecision.chat.budgetSpent')
+                      : t('forkDecision.chat.placeholder')
+                  "
+                  class="min-h-0 flex-1 resize-y rounded-md border border-slate-700 bg-slate-950/60 px-2.5 py-1.5 text-[12px] text-slate-100 placeholder:text-slate-600 focus:border-violet-500 focus:outline-none disabled:opacity-50"
+                  @keydown.enter.exact.prevent="onSend"
+                />
+                <UButton
+                  data-testid="fork-chat-send"
+                  color="neutral"
+                  variant="soft"
+                  size="sm"
+                  icon="i-lucide-send"
+                  :loading="forkDecision.chatting"
+                  :disabled="!canChat || chatInput.trim().length === 0"
+                  @click="onSend"
+                >
+                  {{ t('forkDecision.chat.send') }}
+                </UButton>
+              </div>
+            </section>
           </div>
 
           <!-- Skipped / no state: nothing to decide. -->
@@ -276,7 +368,7 @@ async function onChoose() {
         </div>
 
         <footer
-          v-if="awaiting"
+          v-if="interactive"
           class="flex items-center justify-end gap-2 border-t border-slate-800 px-5 py-3"
         >
           <UButton color="neutral" variant="ghost" size="sm" @click="close">

package/app/components/pipeline/PipelineProgress.vue

@@ -554,6 +554,8 @@ const ITEM_ICON: Record<string, string> = {
           <button
             v-if="forkPhase(s)"
             type="button"
+            data-testid="fork-decision-open"
+            :data-fork-phase="forkPhase(s)"
             class="mt-3 flex w-full items-center gap-2 rounded-lg border border-dashed px-2.5 py-1.5 text-start transition hover:border-violet-400/60"
             :class="
               forkPhase(s) === 'awaiting_choice'

package/app/composables/api/forkDecision.ts

@@ -1,4 +1,8 @@
-import { chooseForkContract, getForkDecisionContract } from '@cat-factory/contracts'
+import {
+  chooseForkContract,
+  forkChatContract,
+  getForkDecisionContract,
+} from '@cat-factory/contracts'
 import type { ApiContext } from './context'
 
 /**
@@ -14,6 +18,14 @@ export function forkDecisionApi({ send, ws }: ApiContext) {
     getForkDecision: (workspaceId: string, executionId: string) =>
       send(getForkDecisionContract, { pathPrefix: ws(workspaceId), pathParams: { executionId } }),
 
+    // Send a grounded chat message about the surfaced forks (the reply arrives via the stream).
+    forkChat: (workspaceId: string, executionId: string, text: string) =>
+      send(forkChatContract, {
+        pathPrefix: ws(workspaceId),
+        pathParams: { executionId },
+        body: { text },
+      }),
+
     // Choose an implementation approach — a proposed fork id or a custom approach (+ note).
     chooseFork: (
       workspaceId: string,

package/app/stores/forkDecision.ts

@@ -20,6 +20,8 @@ export const useForkDecisionStore = defineStore('forkDecision', () => {
 
   /** True while a choose call is in flight (drives the Choose button spinner / disabled state). */
   const choosing = ref(false)
+  /** True while a chat send is in flight (drives the chat send spinner / disabled state). */
+  const chatting = ref(false)
   /** The last error message from an action, surfaced inline; cleared on the next action. */
   const error = ref<string | null>(null)
 
@@ -80,5 +82,25 @@ export const useForkDecisionStore = defineStore('forkDecision', () => {
     }
   }
 
-  return { choosing, error, load, choose }
+  /**
+   * Send a grounded chat message about the surfaced forks. The reply is computed inline in the
+   * durable driver and arrives via the execution stream; the immediate response is the
+   * `answering` state (the human message already appended), which we reflect so the thread shows
+   * the sent turn + a "thinking…" bubble without waiting for the stream.
+   */
+  async function chat(executionId: string, text: string): Promise<void> {
+    error.value = null
+    chatting.value = true
+    try {
+      const state = await api.forkChat(workspace.requireId(), executionId, text)
+      reflect(executionId, state as ForkDecisionStepState)
+    } catch (e) {
+      error.value = e instanceof Error ? e.message : 'Failed to send message'
+      throw e
+    } finally {
+      chatting.value = false
+    }
+  }
+
+  return { choosing, chatting, error, load, choose, chat }
 })

package/i18n/locales/de.json

@@ -4610,6 +4610,14 @@
       "title": "Eigenen Ansatz eingeben",
       "placeholder": "Beschreibe, wie dies umgesetzt werden soll…"
     },
+    "chat": {
+      "title": "Zu diesen Ansätzen nachfragen",
+      "hint": "Unsicher, welchen Sie wählen sollen? Stellen Sie vor der Entscheidung eine Frage.",
+      "thinking": "Denkt nach …",
+      "placeholder": "Fragen Sie nach Kompromissen, Risiken oder einer anderen Richtung …",
+      "budgetSpent": "Chat-Limit erreicht – wählen Sie einen Ansatz oder geben Sie einen eigenen ein.",
+      "send": "Senden"
+    },
     "empty": {
       "title": "Nichts zu entscheiden"
     }

package/i18n/locales/en.json

@@ -4727,6 +4727,14 @@
       "title": "Enter your own approach",
       "placeholder": "Describe how you want this implemented…"
     },
+    "chat": {
+      "title": "Ask about these approaches",
+      "hint": "Not sure which to pick? Ask a question before you decide.",
+      "thinking": "Thinking…",
+      "placeholder": "Ask about the trade-offs, risks, or a different direction…",
+      "budgetSpent": "Chat limit reached — pick an approach or enter your own.",
+      "send": "Send"
+    },
     "empty": {
       "title": "Nothing to decide"
     }

package/i18n/locales/es.json

@@ -4598,6 +4598,14 @@
       "title": "Introduce tu propio enfoque",
       "placeholder": "Describe cómo quieres que se implemente…"
     },
+    "chat": {
+      "title": "Pregunta sobre estos enfoques",
+      "hint": "¿No sabes cuál elegir? Haz una pregunta antes de decidir.",
+      "thinking": "Pensando…",
+      "placeholder": "Pregunta por las ventajas y desventajas, los riesgos o una dirección distinta…",
+      "budgetSpent": "Límite del chat alcanzado: elige un enfoque o introduce el tuyo.",
+      "send": "Enviar"
+    },
     "empty": {
       "title": "Nada que decidir"
     }

package/i18n/locales/fr.json

@@ -4598,6 +4598,14 @@
       "title": "Saisir votre propre approche",
       "placeholder": "Décrivez comment vous voulez que ce soit implémenté…"
     },
+    "chat": {
+      "title": "Poser une question sur ces approches",
+      "hint": "Vous hésitez ? Posez une question avant de décider.",
+      "thinking": "Réflexion en cours…",
+      "placeholder": "Interrogez sur les compromis, les risques ou une autre direction…",
+      "budgetSpent": "Limite de discussion atteinte — choisissez une approche ou saisissez la vôtre.",
+      "send": "Envoyer"
+    },
     "empty": {
       "title": "Rien à décider"
     }

package/i18n/locales/he.json

@@ -4609,6 +4609,14 @@
       "title": "הזן גישה משלך",
       "placeholder": "תאר כיצד ברצונך שזה ימומש…"
     },
+    "chat": {
+      "title": "שאל על הגישות האלה",
+      "hint": "לא בטוח מה לבחור? שאל שאלה לפני שתחליט.",
+      "thinking": "חושב…",
+      "placeholder": "שאל על היתרונות והחסרונות, הסיכונים או כיוון אחר…",
+      "budgetSpent": "הגעת למגבלת הצ׳אט — בחר גישה או הזן גישה משלך.",
+      "send": "שלח"
+    },
     "empty": {
       "title": "אין מה להחליט"
     }

package/i18n/locales/it.json

@@ -4610,6 +4610,14 @@
       "title": "Inserisci il tuo approccio",
       "placeholder": "Descrivi come vuoi che venga implementato…"
     },
+    "chat": {
+      "title": "Fai una domanda su questi approcci",
+      "hint": "Non sai quale scegliere? Fai una domanda prima di decidere.",
+      "thinking": "Sto pensando…",
+      "placeholder": "Chiedi dei compromessi, dei rischi o di una direzione diversa…",
+      "budgetSpent": "Limite della chat raggiunto: scegli un approccio o inserisci il tuo.",
+      "send": "Invia"
+    },
     "empty": {
       "title": "Nulla da decidere"
     }

package/i18n/locales/ja.json

@@ -4610,6 +4610,14 @@
       "title": "独自のアプローチを入力",
       "placeholder": "どのように実装したいか記述してください…"
     },
+    "chat": {
+      "title": "これらのアプローチについて質問する",
+      "hint": "どれを選ぶか迷っていますか？決める前に質問できます。",
+      "thinking": "考えています…",
+      "placeholder": "トレードオフやリスク、別の方向性について質問してください…",
+      "budgetSpent": "チャットの上限に達しました。アプローチを選ぶか、独自の方法を入力してください。",
+      "send": "送信"
+    },
     "empty": {
       "title": "決定する項目はありません"
     }

package/i18n/locales/pl.json

@@ -4598,6 +4598,14 @@
       "title": "Wpisz własne podejście",
       "placeholder": "Opisz, jak chcesz to zaimplementować…"
     },
+    "chat": {
+      "title": "Zapytaj o te podejścia",
+      "hint": "Nie wiesz, które wybrać? Zadaj pytanie przed podjęciem decyzji.",
+      "thinking": "Myślę…",
+      "placeholder": "Zapytaj o kompromisy, ryzyko lub inny kierunek…",
+      "budgetSpent": "Osiągnięto limit czatu — wybierz podejście lub wprowadź własne.",
+      "send": "Wyślij"
+    },
     "empty": {
       "title": "Nie ma czego decydować"
     }

package/i18n/locales/tr.json

@@ -4610,6 +4610,14 @@
       "title": "Kendi yaklaşımınızı girin",
       "placeholder": "Bunun nasıl uygulanmasını istediğinizi açıklayın…"
     },
+    "chat": {
+      "title": "Bu yaklaşımlar hakkında soru sorun",
+      "hint": "Hangisini seçeceğinizden emin değil misiniz? Karar vermeden önce soru sorun.",
+      "thinking": "Düşünüyor…",
+      "placeholder": "Ödünleşimleri, riskleri veya farklı bir yönü sorun…",
+      "budgetSpent": "Sohbet sınırına ulaşıldı — bir yaklaşım seçin veya kendinizinkini girin.",
+      "send": "Gönder"
+    },
     "empty": {
       "title": "Karar verilecek bir şey yok"
     }

package/i18n/locales/uk.json

@@ -4598,6 +4598,14 @@
       "title": "Введіть власний підхід",
       "placeholder": "Опишіть, як ви хочете це реалізувати…"
     },
+    "chat": {
+      "title": "Запитайте про ці підходи",
+      "hint": "Не впевнені, що обрати? Поставте запитання, перш ніж вирішувати.",
+      "thinking": "Обмірковую…",
+      "placeholder": "Запитайте про компроміси, ризики або інший напрям…",
+      "budgetSpent": "Досягнуто ліміту чату — оберіть підхід або введіть власний.",
+      "send": "Надіслати"
+    },
     "empty": {
       "title": "Нема чого вирішувати"
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.114.0",
+  "version": "0.115.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",
@@ -34,7 +34,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.39",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.126.0"
+    "@cat-factory/contracts": "0.127.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",