@7n/tauri-components 0.10.1 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.11.0] - 2026-07-17
+
+### Removed
+
+- useAgent()/createAgentKit (omlx/runAgent chat-completion шлях) видалено — `useAcpAgent()`/`createAcpAgentKit` (ACP: спавн codex/claude/cursor/pi) тепер єдиний агентний шлях. Разом з ним прибрано `core/llm.js`, `core/agent-handler.js`, `core/omlx-models.js`, `core/resolve-omlx-base-url.js`, `vue/use-omlx.js` та Rust-команду `omlx_config` (tauri-plugin-agent)
+
 ## [0.10.1] - 2026-07-16
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/tauri-components",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "type": "module",
   "description": "Shared LLM agent engine + Vue/Quasar UI for Tauri apps (chat, journal, trust-tier approval).",
   "license": "MIT",

package/src/components/AgentDialog.vue

@@ -3,33 +3,26 @@
     @update:model-value="val => emit('update:modelValue', val)"
     @show="onShow"
     :model-value="modelValue"
-    title="Agent (local LLM)"
+    title="Agent"
     icon="sym_o_smart_toy"
     :width="560"
-    body-class="q-gutter-sm"
-  >
+    body-class="q-gutter-sm">
     <template #header>
-      <q-btn @click="showConfig = !showConfig" icon="sym_o_tune" flat round dense size="sm" title="omlx config" />
+      <q-btn @click="showConfig = !showConfig" icon="sym_o_tune" flat round dense size="sm" title="agent config" />
     </template>
 
     <template v-if="showConfig">
-      <q-input v-model="baseUrl" dense outlined label="omlx base URL" />
+      <q-select v-model="agentKind" :options="availableAgentKinds" dense outlined label="agent" />
       <q-select
-        v-model="model"
-        :options="models"
-        @filter="(_, update) => update()"
-        :loading="modelsLoading"
-        use-input
-        fill-input
-        hide-selected
-        input-debounce="0"
-        new-value-mode="add-unique"
+        v-model="modelTier"
+        :options="availableTiers"
+        option-value="id"
+        option-label="label"
+        emit-value
+        map-options
         dense
         outlined
-        label="model"
-        hint="завантажені моделі omlx; можна вписати свою"
-      />
-      <q-input v-model="apiKey" dense outlined label="API key" type="password" />
+        label="tier" />
       <q-separator class="q-my-sm" />
     </template>
 
@@ -38,9 +31,7 @@
         <div v-if="turn.role === 'user'" class="chat-user">{{ turn.text }}</div>
         <RequestView v-else :result="turn.result" />
       </template>
-      <div v-if="running" class="chat-thinking">
-        <q-spinner-dots size="18px" /> думаю…
-      </div>
+      <div v-if="running" class="chat-thinking"><q-spinner-dots size="18px" /> думаю…</div>
     </div>
 
     <q-input
@@ -52,8 +43,7 @@
       type="textarea"
       autogrow
       :label="inputLabel"
-      :hint="promptHint"
-    />
+      :hint="promptHint" />
 
     <!-- jscpd:ignore-start — formal footer markup; jscpd html-mode aligns its
          attribute tokens with an unrelated import block (no shared logic) -->
@@ -64,8 +54,7 @@
         :submit-label="sendLabel"
         icon="sym_o_play_arrow"
         :disable="sendDisabled"
-        :loading="running"
-      />
+        :loading="running" />
     </template>
     <!-- jscpd:ignore-end -->
   </BaseDialog>
@@ -78,17 +67,17 @@ import BaseDialog from './BaseDialog.vue'
 import DialogActions from './DialogActions.vue'
 import RequestView from './RequestView.vue'
 
-// The agent gateway is injected by the host app (`useAgent({ catalog, … })` from
-// @7n/tauri-components/vue), so this dialog stays domain-free and testable.
+// The agent gateway is injected by the host app (`useAcpAgent({ catalog, … })`
+// from @7n/tauri-components/vue), so this dialog stays domain-free and testable.
 const props = defineProps({
   modelValue: { type: Boolean, default: false },
   agent: { type: Object, required: true },
-  promptHint: { type: String, default: 'наприклад: Create a task named deploy in /Users/.../mt, agent mode' },
+  promptHint: { type: String, default: 'наприклад: Create a task named deploy in /Users/.../mt, agent mode' }
 })
 const emit = defineEmits(['update:modelValue', 'ran'])
 
 const $q = useQuasar()
-const { baseUrl, model, apiKey, saveOmlx, loadOmlxEnv, listModels, request, respond } = props.agent
+const { agentKind, modelTier, availableAgentKinds, availableTiers, loadEnv, request, respond } = props.agent
 
 const prompt = ref('')
 const running = ref(false)
@@ -96,8 +85,6 @@ const turns = ref([])
 const requestId = ref(null)
 const logEl = ref(null)
 const showConfig = ref(false)
-const models = ref([])
-const modelsLoading = ref(false)
 
 // Labels shift once a conversation is under way (fresh request → follow-up).
 const inputLabel = computed(() => (turns.value.length ? 'Повідомлення' : 'Prompt'))
@@ -105,23 +92,13 @@ const sendLabel = computed(() => (turns.value.length ? 'Надіслати' : '
 const sendDisabled = computed(() => running.value || !prompt.value.trim())
 
 /**
- * Pull omlx config from the user's global settings; reset the conversation.
+ * Resolve the per-machine default agent + start the domain MCP bridge; reset the conversation.
  */
 async function onShow() {
   prompt.value = ''
   turns.value = []
   requestId.value = null
-  await loadOmlxEnv()
-  // Populate the model dropdown from the omlx server (best-effort; stays editable).
-  if (listModels) {
-    modelsLoading.value = true
-    try {
-      models.value = await listModels()
-    }
-    finally {
-      modelsLoading.value = false
-    }
-  }
+  await loadEnv()
 }
 
 /**
@@ -154,12 +131,10 @@ async function send() {
   scrollToEnd()
   running.value = true
   try {
-    saveOmlx()
     apply(await (requestId.value ? respond(requestId.value, text) : request(text)))
   } catch (error) {
     $q.notify({ type: 'negative', message: String(error?.message ?? error) })
-  }
-  finally {
+  } finally {
     running.value = false
   }
 }

package/src/components/AuditDialog.vue

@@ -6,8 +6,7 @@
     title="Request journal"
     icon="sym_o_history"
     :width="680"
-    body-class=""
-  >
+    body-class="">
     <template #header>
       <q-btn @click="refresh" icon="sym_o_refresh" flat round dense size="sm" :loading="loading" title="Refresh" />
     </template>
@@ -36,8 +35,7 @@
               color="negative"
               unelevated
               no-caps
-              :loading="busyId === rec.id"
-            />
+              :loading="busyId === rec.id" />
             <q-btn @click="onApprove(rec, false)" label="Відхилити" flat no-caps :disable="busyId === rec.id" />
           </div>
         </div>
@@ -57,7 +55,7 @@ import StatePill from './StatePill.vue'
 // keeping this dialog domain-free.
 const props = defineProps({
   modelValue: { type: Boolean, default: false },
-  agent: { type: Object, required: true },
+  agent: { type: Object, required: true }
 })
 const emit = defineEmits(['update:modelValue', 'changed'])
 
@@ -84,11 +82,9 @@ async function refresh() {
   loading.value = true
   try {
     records.value = await journal.list()
-  }
-  catch (error) {
+  } catch (error) {
     $q.notify({ type: 'negative', message: String(error?.message ?? error) })
-  }
-  finally {
+  } finally {
     loading.value = false
   }
 }
@@ -111,11 +107,9 @@ async function onRespond(rec, message) {
     await respond(rec.id, message)
     await refresh()
     emit('changed')
-  }
-  catch (error) {
+  } catch (error) {
     $q.notify({ type: 'negative', message: String(error?.message ?? error) })
-  }
-  finally {
+  } finally {
     busyId.value = null
   }
 }
@@ -131,11 +125,9 @@ async function onApprove(rec, ok) {
     await approve(rec.id, ok)
     await refresh()
     emit('changed')
-  }
-  catch (error) {
+  } catch (error) {
     $q.notify({ type: 'negative', message: String(error?.message ?? error) })
-  }
-  finally {
+  } finally {
     busyId.value = null
   }
 }

package/src/components/BaseDialog.vue

@@ -1,9 +1,5 @@
 <template>
-  <q-dialog
-    @update:model-value="value => emit('update:modelValue', value)"
-    v-bind="$attrs"
-    :model-value="modelValue"
-  >
+  <q-dialog @update:model-value="value => emit('update:modelValue', value)" v-bind="$attrs" :model-value="modelValue">
     <q-card class="base-dialog" :style="{ width: `${width}px` }">
       <q-card-section class="row items-center no-wrap q-pb-sm">
         <q-icon v-if="icon" :name="icon" size="20px" class="q-mr-sm" />
@@ -40,7 +36,7 @@ defineProps({
   title: { type: String, required: true },
   icon: { type: String, default: '' },
   width: { type: Number, default: 520 },
-  bodyClass: { type: String, default: 'q-gutter-md' },
+  bodyClass: { type: String, default: 'q-gutter-md' }
 })
 const emit = defineEmits(['update:modelValue'])
 </script>

package/src/components/DialogActions.vue

@@ -8,8 +8,7 @@
     :loading="loading"
     color="primary"
     unelevated
-    no-caps
-  />
+    no-caps />
 </template>
 
 <script setup>
@@ -20,7 +19,7 @@ defineProps({
   submitLabel: { type: String, required: true },
   icon: { type: String, default: undefined },
   disable: { type: Boolean, default: false },
-  loading: { type: Boolean, default: false },
+  loading: { type: Boolean, default: false }
 })
 const emit = defineEmits(['submit'])
 </script>

package/src/components/RequestView.vue

@@ -11,8 +11,7 @@
         <q-icon
           :name="action.envelope?.ok ? 'sym_o_check_circle' : 'sym_o_error'"
           :color="action.envelope?.ok ? 'positive' : 'negative'"
-          size="14px"
-        />
+          size="14px" />
         <code>{{ action.tool }}({{ JSON.stringify(action.input) }})</code>
       </div>
     </div>
@@ -23,7 +22,7 @@
 import StatePill from './StatePill.vue'
 
 defineProps({
-  result: { type: Object, required: true },
+  result: { type: Object, required: true }
 })
 </script>
 

package/src/components/StatePill.vue

@@ -11,7 +11,7 @@
 import { statusColor } from './status.js'
 
 defineProps({
-  status: { type: String, required: true },
+  status: { type: String, required: true }
 })
 </script>
 

package/src/components/docs/AgentDialog.md

@@ -1,12 +1,12 @@
 ---
+type: Vue Component
+title: AgentDialog.vue
+resource: npm/src/components/AgentDialog.vue
 docgen:
-  source: npm/src/components/AgentDialog.vue
-  crc: 197cc9c0
+  crc: aa14e51b
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
 ---
 
-# AgentDialog.vue
-
 Компонент відображає діалогове вікно для взаємодії з локальною мовною моделлю (LLM) через агент. Він дозволяє користувачеві вводити запити, налаштовувати конфігурацію агента та бачити історію чату.
 
 ## Поведінка

package/src/components/docs/index.md

@@ -1,14 +1,14 @@
 ---
+type: JS Module
+title: index.js
+resource: npm/src/components/index.js
 docgen:
-  source: npm/src/components/index.js
-  crc: 42b50c52
+  crc: 6d136e3a
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
-# index.js
-
 ## Огляд
 
 Компоненти цього файлу керують відображенням діалогових вікон, які взаємодіють з агентом. Експортується базовий клас для діалогів, компоненти для відображення специфічних дій, деталей запиту та поточного стану, а також константи для визначення кольорів стану.

package/src/components/index.js

@@ -1,6 +1,6 @@
 // `@7n/tauri-components/components` — Quasar dialogs for the agent. AgentDialog
-// and AuditDialog take the injected `agent` gateway (from ./vue useAgent) via a
-// prop; the rest are pure props-only building blocks. Requires the host app to
+// and AuditDialog take the injected `agent` gateway (from ./vue useAcpAgent) via
+// a prop; the rest are pure props-only building blocks. Requires the host app to
 // provide vue + quasar (peer deps) and to have Quasar installed.
 
 export { default as AgentDialog } from './AgentDialog.vue'

package/src/components/status.js

@@ -9,7 +9,7 @@ export const STATUS_COLOR = {
   needs_clarification: '#64d2ff',
   needs_approval: '#ff9f0a',
   failed: '#ff453a',
-  rejected: '#8e8e93',
+  rejected: '#8e8e93'
 }
 
 const FALLBACK = '#8e8e93'

package/src/core/acp-agent-presets.js

@@ -20,6 +20,6 @@ export const CODEX_ACP_AGENT_PRESET = {
   tiers: {
     MIN: { label: 'GPT-5.6 Luna', env: codexModelEnv('gpt-5.6-luna') },
     AVG: { label: 'GPT-5.6 Terra', env: codexModelEnv('gpt-5.6-terra') },
-    MAX: { label: 'GPT-5.6 Sol', env: codexModelEnv('gpt-5.6-sol') },
-  },
+    MAX: { label: 'GPT-5.6 Sol', env: codexModelEnv('gpt-5.6-sol') }
+  }
 }

package/src/core/acp-agent.js

@@ -1,13 +1,11 @@
 import { invoke } from '@tauri-apps/api/core'
 import { listen } from '@tauri-apps/api/event'
 
-// ACP session driver: the replacement for llm.js's runAgent()/createOpenAiChat.
-// Instead of running our own chat-completion loop, we spawn an external ACP
-// agent (codex-acp/claude-agent-acp/cursor `agent acp`/pi-acp) via the Rust
-// plugin's acp_* commands and stream its `session/update` notifications back
-// into the same {content, trace, messages, stopped?} shape runAgent() used to
-// return, so agent-handler.js's runAndJournal needs no structural changes —
-// only which turn-runner it calls.
+// ACP session driver: instead of running our own chat-completion loop, we
+// spawn an external ACP agent (codex-acp/claude-agent-acp/cursor `agent acp`/
+// pi-acp) via the Rust plugin's acp_* commands and stream its `session/update`
+// notifications back into a {content, trace, messages, stopped?} shape that
+// acp-kit.js's runAndJournal folds straight into the journal.
 //
 // Domain-tool approval (the MCP bridge's `acp://mcp-tool-call`) and native ACP
 // permission requests (`acp://permission-request`) are separate event streams
@@ -30,9 +28,18 @@ import { listen } from '@tauri-apps/api/event'
  * @param {boolean} [params.allowTerminal] grant terminal/*
  * @returns {Promise<{sessionKey: string, agentKind: string}>} session handle
  */
-export async function createAcpSession({ agentKind, command, args = [], env = {}, cwd, mcpBridgeUrl, allowFs = false, allowTerminal = false }) {
+export async function createAcpSession({
+  agentKind,
+  command,
+  args = [],
+  env = {},
+  cwd,
+  mcpBridgeUrl,
+  allowFs = false,
+  allowTerminal = false
+}) {
   const sessionKey = await invoke('plugin:agent|acp_spawn_agent', {
-    args: { command, args, env, cwd, mcpBridgeUrl, allowFs, allowTerminal },
+    args: { command, args, env, cwd, mcpBridgeUrl, allowFs, allowTerminal }
   })
   return { sessionKey, agentKind }
 }
@@ -70,7 +77,7 @@ function applySessionUpdate(state, update) {
       state.calls.set(update.toolCallId, {
         tool: update.title ?? update.toolCallId,
         input: update.rawInput ?? {},
-        envelope: null,
+        envelope: null
       })
       break
     }
@@ -100,7 +107,7 @@ function applySessionUpdate(state, update) {
 export async function runAcpTurn({ sessionKey, text, onChunk }) {
   const state = { text: '', messageId: null, calls: new Map() }
 
-  const unlisten = await listen('acp://session-update', (event) => {
+  const unlisten = await listen('acp://session-update', event => {
     if (event.payload?.sessionKey !== sessionKey) return
     applySessionUpdate(state, event.payload.update)
     onChunk?.(event.payload.update)
@@ -115,10 +122,9 @@ export async function runAcpTurn({ sessionKey, text, onChunk }) {
       steps: 1,
       trace,
       messages,
-      stopped: stoppedFromStopReason(stopReason),
+      stopped: stoppedFromStopReason(stopReason)
     }
-  }
-  finally {
+  } finally {
     unlisten()
   }
 }
@@ -175,7 +181,7 @@ export function respondAcpPermission(requestId, optionId) {
 
 /**
  * Register this app's tool catalog with the domain MCP bridge and start it.
- * @param {object[]} catalog tool definitions (same shape passed to `createAgentKit`)
+ * @param {object[]} catalog tool definitions (same shape passed to `createAcpAgentKit`)
  * @returns {Promise<string>} the bridge's loopback URL, e.g. `http://127.0.0.1:54321/`
  */
 export async function startAcpMcpBridge(catalog) {

package/src/core/acp-kit.js

@@ -3,17 +3,15 @@ import { createDispatch } from './dispatch.js'
 import { classify, DEFAULT_ACTOR_TIERS } from './scope.js'
 
 // createAcpAgentKit binds an app's catalog + journal to the ACP execution
-// engine — the ACP-flavored sibling of createAgentKit (agent-kit.js), added
-// alongside it so existing consumers keep working on the old omlx/runAgent
-// path while migrating at their own pace (see SPEC / plan for the sequencing).
+// engine — the sole agent kit (the earlier omlx/runAgent-based createAgentKit
+// has been removed; see CHANGELOG).
 //
-// The two engines differ in where tool dispatch happens: runAgent() drove its
-// own tool-calling loop and dispatched synchronously inside handleRequest.
-// Here the ACP agent process drives its OWN loop and calls domain tools
-// through the Rust-side MCP bridge — so dispatch is triggered by a STANDING
-// listener on `acp://mcp-tool-call`, not by anything in request()/respond().
-// Every such call is tier-classified as an `{kind:'agent'}` actor, since by
-// construction only an autonomous agent process can reach the bridge.
+// The ACP agent process drives its OWN tool-calling loop and calls domain
+// tools through the Rust-side MCP bridge — so dispatch is triggered by a
+// STANDING listener on `acp://mcp-tool-call`, not by anything in
+// request()/respond(). Every such call is tier-classified as an
+// `{kind:'agent'}` actor, since by construction only an autonomous agent
+// process can reach the bridge.
 //
 // Scope: one active session/request at a time, matching how AgentDialog is
 // actually used today (a single live conversation). A tool call or permission
@@ -43,7 +41,7 @@ function finalizeTurn(turn) {
   if (turn.stopped === 'max_steps' || turn.stopped === 'refusal') status = 'partial'
   else if (turn.stopped === 'cancelled') status = 'partial'
   else if (question) status = 'needs_clarification'
-  return { status, summary: question ? null : (turn.content || null), question }
+  return { status, summary: question ? null : turn.content || null, question }
 }
 
 /**
@@ -53,9 +51,15 @@ function finalizeTurn(turn) {
  * @param {(tool: object, input: object) => unknown} [config.transport] backend runner for domain tools; omit for a chat-only kit (no domain MCP tools)
  * @param {Record<string, number>} [config.actorTiers] max executable tier rank per actor kind
  * @param {object} [config.deps] injectable `acp-agent.js` functions (tests only — defaults to the real module)
- * @returns {{request: Function, respond: Function, approve: Function}} bound kit
+ * @returns {{request: (opts: {intent: string, agent: object}) => Promise<object>, respond: (opts: {requestId: string, message: string}) => Promise<object>, approve: (opts: {requestId: string, approve: boolean}) => Promise<object>}} bound kit
  */
-export function createAcpAgentKit({ catalog, journal, transport, actorTiers = DEFAULT_ACTOR_TIERS, deps = acpAgent } = {}) {
+export function createAcpAgentKit({
+  catalog,
+  journal,
+  transport,
+  actorTiers = DEFAULT_ACTOR_TIERS,
+  deps = acpAgent
+} = {}) {
   if (!Array.isArray(catalog)) throw new Error('createAcpAgentKit: catalog (array) is required')
 
   const dispatch = transport ? createDispatch(catalog, transport) : null
@@ -71,17 +75,26 @@ export function createAcpAgentKit({ catalog, journal, transport, actorTiers = DE
    */
   async function handleToolCall({ requestId, tool, input }) {
     if (!dispatch) {
-      await deps.respondAcpToolCall(requestId, { ok: false, error: { code: 'forbidden', message: 'No transport configured.' } })
+      await deps.respondAcpToolCall(requestId, {
+        ok: false,
+        error: { code: 'forbidden', message: 'No transport configured.' }
+      })
       return
     }
     const decision = classify(catalog, actorTiers, AGENT_ACTOR, tool)
     if (decision === 'deny') {
-      await deps.respondAcpToolCall(requestId, { ok: false, error: { code: 'forbidden', message: `Tool "${tool}" is not allowed.` } })
+      await deps.respondAcpToolCall(requestId, {
+        ok: false,
+        error: { code: 'forbidden', message: `Tool "${tool}" is not allowed.` }
+      })
       return
     }
     if (decision === 'approval') {
       if (activeRequestId) {
-        await journal.update(activeRequestId, { status: 'needs_approval', pendingApproval: { kind: 'mcp', requestId, tool, input } })
+        await journal.update(activeRequestId, {
+          status: 'needs_approval',
+          pendingApproval: { kind: 'mcp', requestId, tool, input }
+        })
       }
       return // acp_mcp_tool_result comes later, from approve()
     }
@@ -127,8 +140,7 @@ export function createAcpAgentKit({ catalog, journal, transport, actorTiers = DE
     let turn
     try {
       turn = await turnPromise
-    }
-    catch (error) {
+    } catch (error) {
       await journal.update(requestId, { status: 'failed', error: String(error?.message ?? error) })
       return { requestId, status: 'failed', summary: null, actions: baseActions, question: null, pendingApproval: null }
     }
@@ -163,18 +175,35 @@ export function createAcpAgentKit({ catalog, journal, transport, actorTiers = DE
      */
     async respond({ requestId, message }) {
       if (!activeSessionKey) {
-        return { requestId, status: 'failed', summary: null, actions: [], question: 'No active ACP session.', pendingApproval: null }
+        return {
+          requestId,
+          status: 'failed',
+          summary: null,
+          actions: [],
+          question: 'No active ACP session.',
+          pendingApproval: null
+        }
       }
       let record
       try {
         record = await journal.load(requestId)
-      }
-      catch {
-        return { requestId, status: 'failed', summary: null, actions: [], question: 'Request not found.', pendingApproval: null }
+      } catch {
+        return {
+          requestId,
+          status: 'failed',
+          summary: null,
+          actions: [],
+          question: 'Request not found.',
+          pendingApproval: null
+        }
       }
       await journal.update(requestId, { status: 'running' })
       activeRequestId = requestId
-      return runAndJournal(requestId, record.actions ?? [], deps.runAcpTurn({ sessionKey: activeSessionKey, text: message }))
+      return runAndJournal(
+        requestId,
+        record.actions ?? [],
+        deps.runAcpTurn({ sessionKey: activeSessionKey, text: message })
+      )
     },
 
     /**
@@ -187,19 +216,32 @@ export function createAcpAgentKit({ catalog, journal, transport, actorTiers = DE
       let record
       try {
         record = await journal.load(requestId)
-      }
-      catch {
-        return { requestId, status: 'failed', summary: null, actions: [], question: 'Request not found.', pendingApproval: null }
+      } catch {
+        return {
+          requestId,
+          status: 'failed',
+          summary: null,
+          actions: [],
+          question: 'Request not found.',
+          pendingApproval: null
+        }
       }
 
       const pending = record.pendingApproval
       if (record.status !== 'needs_approval' || !pending) {
-        return { requestId, status: record.status, summary: record.summary, actions: record.actions ?? [], question: null, pendingApproval: null }
+        return {
+          requestId,
+          status: record.status,
+          summary: record.summary,
+          actions: record.actions ?? [],
+          question: null,
+          pendingApproval: null
+        }
       }
 
       if (pending.kind === 'acp') return approveAcpPermission(deps, journal, requestId, record, pending, decision)
       return approveMcpToolCall(deps, dispatch, journal, requestId, record, pending, decision)
-    },
+    }
   }
 }
 
@@ -216,7 +258,7 @@ export function createAcpAgentKit({ catalog, journal, transport, actorTiers = DE
  * means the old "retry a failed dispatch" UX doesn't carry over: once the
  * agent has been told a tool call failed, it has already moved on.
  * @param {object} deps injected acp-agent.js functions
- * @param {Function} dispatch bound `createDispatch` result
+ * @param {(name: string, input?: object) => Promise<object>} dispatch bound `createDispatch` result
  * @param {object} journal journal store
  * @param {string} requestId journal record id
  * @param {object} record loaded journal record
@@ -256,5 +298,12 @@ async function approveAcpPermission(deps, journal, requestId, record, pending, d
   await deps.respondAcpPermission(pending.requestId, option?.optionId)
 
   await journal.update(requestId, { status: 'running', pendingApproval: null })
-  return { requestId, status: 'running', summary: null, actions: record.actions ?? [], question: null, pendingApproval: null }
+  return {
+    requestId,
+    status: 'running',
+    summary: null,
+    actions: record.actions ?? [],
+    question: null,
+    pendingApproval: null
+  }
 }