@7n/tauri-components 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -0,0 +1,87 @@
+# 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
+
+- chore(lint): дозаповнено cspell-словник, авто-fix markdownlint у docs/
+
+## [0.10.0] - 2026-07-16
+
+### Added
+
+- core/acp-agent-presets.js — CODEX_ACP_AGENT_PRESET: спільний для всіх застосунків-споживачів пресет запуску codex через ACP (npx @agentclientprotocol/codex-acp — гола назва "codex-acp" не опублікована), MIN/AVG/MAX тіри за схемою назв релізів codex (gpt-5.6-luna/terra/sol) через CODEX_CONFIG. Експортовано з npm/src/index.js.
+
+## [0.9.0] - 2026-07-15
+
+### Added
+
+- core/acp-agent.js — ACP-сесії (spawn/prompt/cancel), стрім session/update у форму runAgent(), перший крок міграції з прямих omlx-викликів на Agent Client Protocol
+- core/acp-kit.js — ACP-версія createAgentKit: класифікація/dispatch домен-каталогу через MCP tools/call (acp://mcp-tool-call), дзеркалення нативних ACP permission-request у той самий pendingApproval-контракт, що і approve()/AuditDialog вже розуміють. Одна активна сесія за раз.
+- vue/use-acp-agent.js — Vue-composабл useAcpAgent(): резолвинг дефолтного агента через ACP_DEFAULT_AGENT (per-машина), MIN/AVG/MAX модель-тіри на пресет (per-агент), запуск domain MCP-моста при loadEnv(). Паралельний до useAgent(), старий шлях не чіпали.
+
+## [0.8.0] - 2026-07-05
+
+### Added
+
+- useUpdater() у @7n/tauri-components/vue — спільна перевірка/встановлення оновлень через tauri-plugin-updater з Quasar-діалогом, винесена з mlmail/myshare/myllm/task (усі чотири мали ідентичну копію).
+
+## [0.7.0] - 2026-07-02
+
+### Added
+
+- Фолбек на myllm-проксі: loadEnv() у useOmlx пробує `:8088/health` (timeout 400ms, кеш 12с) і, коли проксі живий, веде трафік через нього замість прямого `:8000` — runtime-only override, localStorage і кастомні baseUrl не чіпаються. Нові core-експорти: resolveOmlxBaseUrl / resolveOmlxBaseUrlCached / isDirectOmlxUrl / DIRECT_OMLX_BASE_URL / PROXY_OMLX_BASE_URL.
+
+## [0.6.0] - 2026-06-22
+
+### Changed
+
+- Додано пропс promptHint до AgentDialog.vue
+
+## [0.5.0] - 2026-06-19
+
+### Added
+
+- testing subpath (mountQuasar/mountWithQuasar vitest helpers); omlx model listing (listOmlxModels/resolveModel) + a model dropdown in AgentDialog populated from the server
+
+## [0.4.1] - 2026-06-19
+
+### Fixed
+
+- useOmlx no longer crashes when localStorage is unavailable (component tests / SSR) — guarded reads/writes
+
+## [0.4.0] - 2026-06-19
+
+### Added
+
+- createDispatch preserves a backend error.kind on the io envelope; useAgent accepts a transport override (route some tools to JS/OPFS handlers)
+
+## [0.3.0] - 2026-06-16
+
+### Changed
+
+- Винесено логіку відображення статусу в StatePill компонент
+
+## [0.2.0] - 2026-06-16
+
+### Changed
+
+- journal/omlx commands now invoked as plugin:agent|* — apps must register tauri-plugin-agent and grant agent:default
+
+## [0.1.1] - 2026-06-16
+
+### Fixed
+
+- npm provenance: add repository metadata so publish passes sigstore validation
+
+## [0.1.0] - 2026-06-16
+
+### Added
+
+- LLM agent engine (createAgentKit, scoped tool surface) + Vue/Quasar UI (AgentDialog, AuditDialog) for Tauri apps

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/tauri-components",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "type": "module",
   "description": "Shared LLM agent engine + Vue/Quasar UI for Tauri apps (chat, journal, trust-tier approval).",
   "license": "MIT",
@@ -25,6 +25,7 @@
   "files": [
     "src",
     "types",
+    "CHANGELOG.md",
     "!**/*.test.*",
     "!**/*.spec.*",
     "!**/__tests__/**",

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"
-        :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; можна вписати свою"
-        @filter="(_, update) => update()"
-      />
-      <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) {