@7n/tauri-components 0.10.1 → 0.11.0

package/src/core/dispatch.js

@@ -20,7 +20,8 @@ export function validateInput(tool, input) {
       continue
     }
     if (spec.type === 'string' && typeof value !== 'string') return `Field "${key}" must be a string`
-    if (spec.type === 'object' && (typeof value !== 'object' || Array.isArray(value))) return `Field "${key}" must be an object`
+    if (spec.type === 'object' && (typeof value !== 'object' || Array.isArray(value)))
+      return `Field "${key}" must be an object`
   }
   return tool.validate ? tool.validate(data) : null
 }
@@ -42,8 +43,7 @@ export function createDispatch(catalog, transport) {
     try {
       const output = await transport(tool, input ?? {})
       return { ok: true, output }
-    }
-    catch (error) {
+    } catch (error) {
       const envelope = { code: 'io', message: String(error?.message ?? error) }
       // Preserve a backend-provided error kind (e.g. a typed Tauri command error)
       // so callers can branch on it — e.g. re-auth on a 'ReauthRequired' kind.

package/src/core/docs/acp-agent.md

@@ -1,15 +1,15 @@
 ---
+type: JS Module
+title: acp-agent.js
+resource: npm/src/core/acp-agent.js
 docgen:
-  source: npm/src/core/acp-agent.js
-  crc: e30fb954
+  crc: a9f48a2c
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
-# acp-agent.js
-
 ## Огляд
 
 Модуль керує життєвим циклом сесій агента ACP. Він дозволяє ініціалізувати сесії за допомогою `createAcpSession`, виконувати ходи промпта через `runAcpTurn` та скасовувати сесії за допомогою `cancelAcpSession`. Модуль встановлює мережевий зв'язок через <http://127.0.0.1:54321/> та ініціалізує MCP-міст за допомогою `startAcpMcpBridge`. Він реєструє інструменти та обробляє запити на виклики інструментів через `onAcpToolCall` та відповіді на них через `respondAcpToolCall`. Модуль також обробляє запити на дозволи через `onAcpPermissionRequest` та надає відповіді за допомогою `respondAcpPermission`. Модуль надає конфігурацію типу агента за допомогою `acpConfig`. Усі помилки перехоплюються (fail-safe), і винятки не викидаються назовні.

package/src/core/docs/acp-kit.md

@@ -1,14 +1,14 @@
 ---
+type: JS Module
+title: acp-kit.js
+resource: npm/src/core/acp-kit.js
 docgen:
-  source: npm/src/core/acp-kit.js
-  crc: caab4cf6
+  crc: 7838ed4e
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
-# acp-kit.js
-
 ## Огляд
 
 Модуль ініціалізує агента та керує життєвим циклом його запитів. Функція `createAcpAgentKit` створює агента на основі заданих компонентів. Модуль дозволяє розпочинати нові запити, продовжувати активні сесії або вирішувати відкладені питання, такі як виклики інструментів чи запити на дозвіл.

package/src/core/manifest.js

@@ -24,14 +24,16 @@ export function toJsonSchema(input) {
  * @returns {object[]} OpenAI `tools` array
  */
 export function toolManifest(catalog, allow = () => true) {
-  return catalog.filter(tool => allow(tool)).map(tool => ({
-    type: 'function',
-    function: {
-      name: tool.name,
-      description: tool.summary,
-      parameters: toJsonSchema(tool.input),
-    },
-  }))
+  return catalog
+    .filter(tool => allow(tool))
+    .map(tool => ({
+      type: 'function',
+      function: {
+        name: tool.name,
+        description: tool.summary,
+        parameters: toJsonSchema(tool.input)
+      }
+    }))
 }
 
 /**

package/src/docs/index.md

@@ -1,11 +1,11 @@
 ---
+type: JS Module
+title: index.js
+resource: npm/src/index.js
 docgen:
-  source: npm/src/index.js
-  crc: 60cbbdaf
+  crc: 4c44e807
 ---
 
-# index.js
-
 ## Огляд
 
 Модуль керує життєвим циклом агента, охоплюючи етапи ініціалізації, виконання та завершення роботи. Він відповідає за налаштування конфігурації, реєстрацію обробників запитів та інструментів. Модуль ініціалізує сесії та забезпечує взаємодію агента з зовнішніми системами, такими як MCP та Omlx, використовуючи лише дані, які є read-only.

package/src/index.js

@@ -1,5 +1,5 @@
-// `@7n/tauri-components` — core (no Vue). The agent loop, tool surface and the
-// kit that binds them to an app catalog. Import this entry from headless
+// `@7n/tauri-components` — core (no Vue). The ACP agent kit and the tool
+// surface it binds to an app catalog. Import this entry from headless
 // consumers (CLI orchestrators, MCP wrappers); the Vue/Quasar layers live under
 // the ./vue and ./components subpaths.
 
@@ -12,16 +12,11 @@ export {
   respondAcpPermission,
   respondAcpToolCall,
   runAcpTurn,
-  startAcpMcpBridge,
+  startAcpMcpBridge
 } from './core/acp-agent.js'
 export { CODEX_ACP_AGENT_PRESET } from './core/acp-agent-presets.js'
 export { createAcpAgentKit } from './core/acp-kit.js'
-export { createAgentKit } from './core/agent-kit.js'
-export { handleApprove, handleRequest, handleRespond } from './core/agent-handler.js'
 export { createDispatch, validateInput } from './core/dispatch.js'
-export { createOpenAiChat, runAgent } from './core/llm.js'
-export { listOmlxModels, resolveModel } from './core/omlx-models.js'
-export { DIRECT_OMLX_BASE_URL, isDirectOmlxUrl, PROXY_OMLX_BASE_URL, resolveOmlxBaseUrl, resolveOmlxBaseUrlCached } from './core/resolve-omlx-base-url.js'
 export { listTools, toJsonSchema, toolManifest } from './core/manifest.js'
 export { classify, DEFAULT_ACTOR_TIERS, scopedManifest, scopedToolNames } from './core/scope.js'
 export { getTool } from './core/tools.js'

package/src/testing/quasar.js

@@ -18,7 +18,7 @@ function quasarGlobal(userGlobal = {}) {
   return {
     ...userGlobal,
     components: { ...quasarComponents, ...userGlobal.components },
-    plugins: [...(userGlobal.plugins || []), [Quasar.Quasar, { config: { dark: false } }]],
+    plugins: [...(userGlobal.plugins || []), [Quasar.Quasar, { config: { dark: false } }]]
   }
 }
 
@@ -42,7 +42,7 @@ export function mountWithQuasar(component, options = {}) {
   const wrapper = {
     render() {
       return h(Quasar.QLayout, { view: 'hHh lpR fFf' }, () => h(Quasar.QPageContainer, () => h(component)))
-    },
+    }
   }
   return mount(wrapper, { ...options, global: quasarGlobal(options.global) })
 }

package/src/vue/docs/index.md

@@ -1,15 +1,15 @@
 ---
+type: JS Module
+title: index.js
+resource: npm/src/vue/index.js
 docgen:
-  source: npm/src/vue/index.js
-  crc: ac7a549c
+  crc: ae0b9450
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
-# index.js
-
 ## Огляд
 
 Цей файл є центральною точкою взаємодії системи. Він забезпечує механізми для комунікації з агентом ACP, загальним агентом та протоколом OMLX. Він створює сховище журналу, використовуючи механізми Tauri, та надає об'єкт для транспортування даних.

package/src/vue/docs/journal-store-tauri.md

@@ -1,15 +1,15 @@
 ---
+type: JS Module
+title: journal-store-tauri.js
+resource: npm/src/vue/journal-store-tauri.js
 docgen:
-  source: npm/src/vue/journal-store-tauri.js
-  crc: 6356740d
+  crc: be2482bb
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.99
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
-# journal-store-tauri.js
-
 ## Огляд
 
 Цей модуль керує доступом до механізму журналу. Він дозволяє створювати сховище журналу та отримувати повний список існуючих записів.

package/src/vue/docs/use-acp-agent.md

@@ -1,15 +1,15 @@
 ---
+type: JS Module
+title: use-acp-agent.js
+resource: npm/src/vue/use-acp-agent.js
 docgen:
-  source: npm/src/vue/use-acp-agent.js
-  crc: 227f9b8b
+  crc: 0477b0ca
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: judge:inaccurate:0.97
   judgeModel: openai-codex/gpt-5.4-mini
 ---
 
-# use-acp-agent.js
-
 ## Огляд
 
 Модуль ініціалізує шлюз агента та налаштовує доменне мостове з'єднання MCP, якщо каталог доступний. Він звертається до мережі для відправки запитів до агента. Публічна функція `useAcpAgent` використовується для передачі намірів агенту, що дозволяє оновлювати рівень моделі. Після цього модуль надає відповідь та схвалює запит. Цей модуль є Read-only і не виконує записів у файлову систему чи бази даних.

package/src/vue/index.js

@@ -1,11 +1,9 @@
-// `@7n/tauri-components/vue` — Vue + Tauri composables. Wires the core agent kit
-// to the webview (omlx over tauri-http, tools/journal over Tauri invoke).
-// Requires the host app to provide vue + @tauri-apps/* (peer deps) and the
-// tauri-plugin-agent backend commands.
+// `@7n/tauri-components/vue` — Vue + Tauri composables. Wires the core ACP
+// agent kit to the webview (spawns codex/claude/cursor/pi via Tauri invoke,
+// tools/journal over Tauri invoke). Requires the host app to provide vue +
+// @tauri-apps/* (peer deps) and the tauri-plugin-agent backend commands.
 
 export { useAcpAgent } from './use-acp-agent.js'
-export { useAgent } from './use-agent.js'
-export { useOmlx } from './use-omlx.js'
 export { useUpdater } from './use-updater.js'
 export { createTauriJournalStore } from './journal-store-tauri.js'
 export { tauriTransport } from './transports.js'

package/src/vue/journal-store-tauri.js

@@ -2,7 +2,7 @@ import { invoke } from '@tauri-apps/api/core'
 
 // Webview journal store: routes journal FS through the shared `tauri-plugin-agent`
 // commands (`plugin:agent|journal_*`, see SPEC §6). Same shape any other store
-// implements, so agent-handler stays backend-agnostic. The host app must
+// implements, so createAcpAgentKit stays backend-agnostic. The host app must
 // register the plugin and grant `agent:default`.
 
 /**
@@ -13,6 +13,6 @@ export function createTauriJournalStore() {
     create: ({ intent, actor }) => invoke('plugin:agent|journal_create', { intent, actor }),
     load: id => invoke('plugin:agent|journal_load', { id }),
     update: (id, patch) => invoke('plugin:agent|journal_update', { id, patch }),
-    list: () => invoke('plugin:agent|journal_list'),
+    list: () => invoke('plugin:agent|journal_list')
   }
 }

package/src/vue/use-acp-agent.js

@@ -4,9 +4,10 @@ import { createAcpAgentKit } from '../core/acp-kit.js'
 import { createTauriJournalStore } from './journal-store-tauri.js'
 import { tauriTransport } from './transports.js'
 
-// In-app ACP agent gateway — the ACP-flavored sibling of `useAgent()` (which
-// stays on the old omlx/runAgent path). Binds an app's catalog to
-// createAcpAgentKit and resolves two independent defaults per SPEC/plan:
+// In-app ACP agent gateway — the sole agent composable (the earlier
+// omlx/runAgent-based `useAgent()` has been removed; see CHANGELOG). Binds an
+// app's catalog to createAcpAgentKit and resolves two independent defaults per
+// SPEC/plan:
 //
 // - which AGENT (codex/claude/cursor/pi) — per-machine, from `ACP_DEFAULT_AGENT`
 //   (via `acp_config()`), since different developers have different CLIs
@@ -17,8 +18,7 @@ import { tauriTransport } from './transports.js'
 //   (`request(intent, { modelTier: 'MAX' })`); otherwise `defaultTier` applies.
 //
 // The domain MCP bridge is started once (`loadEnv()`) and its URL is reused
-// for every spawned session, mirroring how `useOmlx().loadEnv()` resolves the
-// omlx base URL once and reuses it.
+// for every spawned session.
 
 const DEFAULT_TIER = 'AVG'
 
@@ -32,7 +32,14 @@ const DEFAULT_TIER = 'AVG'
  * @param {(tool: object, input: object) => unknown} [config.transport] tool transport (default Tauri invoke)
  * @returns {object} in-app ACP agent gateway
  */
-export function useAcpAgent({ catalog, agents = {}, defaultTier = DEFAULT_TIER, cwd, actorTiers, transport = tauriTransport } = {}) {
+export function useAcpAgent({
+  catalog,
+  agents = {},
+  defaultTier = DEFAULT_TIER,
+  cwd,
+  actorTiers,
+  transport = tauriTransport
+} = {}) {
   const defaultAgentKind = ref(null)
   const agentKind = ref(null)
   const modelTier = ref(defaultTier)
@@ -51,9 +58,9 @@ export function useAcpAgent({ catalog, agents = {}, defaultTier = DEFAULT_TIER,
     const configuredKinds = Object.keys(agents)
     try {
       const cfg = await acpConfig()
-      defaultAgentKind.value = cfg.defaultAgentKind && agents[cfg.defaultAgentKind] ? cfg.defaultAgentKind : (configuredKinds[0] ?? null)
-    }
-    catch {
+      defaultAgentKind.value =
+        cfg.defaultAgentKind && agents[cfg.defaultAgentKind] ? cfg.defaultAgentKind : (configuredKinds[0] ?? null)
+    } catch {
       defaultAgentKind.value = configuredKinds[0] ?? null
     }
     if (!agentKind.value) agentKind.value = defaultAgentKind.value
@@ -61,8 +68,7 @@ export function useAcpAgent({ catalog, agents = {}, defaultTier = DEFAULT_TIER,
     if (catalog?.length) {
       try {
         mcpBridgeUrl.value = await startAcpMcpBridge(catalog)
-      }
-      catch {
+      } catch {
         mcpBridgeUrl.value = null
       }
     }
@@ -82,7 +88,7 @@ export function useAcpAgent({ catalog, agents = {}, defaultTier = DEFAULT_TIER,
       args: [...(preset.args ?? []), ...(tier?.args ?? [])],
       env: { ...preset.env, ...tier?.env },
       cwd,
-      mcpBridgeUrl: mcpBridgeUrl.value ?? undefined,
+      mcpBridgeUrl: mcpBridgeUrl.value ?? undefined
     }
   }
 
@@ -91,7 +97,9 @@ export function useAcpAgent({ catalog, agents = {}, defaultTier = DEFAULT_TIER,
     modelTier,
     defaultAgentKind,
     availableAgentKinds: computed(() => Object.keys(agents)),
-    availableTiers: computed(() => Object.entries(agents[agentKind.value]?.tiers ?? {}).map(([id, t]) => ({ id, label: t.label ?? id }))),
+    availableTiers: computed(() =>
+      Object.entries(agents[agentKind.value]?.tiers ?? {}).map(([id, t]) => ({ id, label: t.label ?? id }))
+    ),
     loadEnv,
     journal,
     /**
@@ -104,6 +112,6 @@ export function useAcpAgent({ catalog, agents = {}, defaultTier = DEFAULT_TIER,
       return kit.request({ intent, agent: resolveSpawnArgs() })
     },
     respond: (requestId, message) => kit.respond({ requestId, message }),
-    approve: (requestId, approve) => kit.approve({ requestId, approve }),
+    approve: (requestId, approve) => kit.approve({ requestId, approve })
   }
 }

package/src/vue/use-updater.js

@@ -45,14 +45,13 @@ export function useUpdater() {
         message: `Версія ${update.version} готова. Встановити зараз?`,
         cancel: { label: 'Пізніше', flat: true },
         ok: { label: 'Встановити', color: 'primary' },
-        persistent: true,
+        persistent: true
       })
         .onOk(() => installAndRelaunch(update))
         .onCancel(() => {
           busy = false
         })
-    }
-    catch (error) {
+    } catch (error) {
       // No network, or the updater isn't configured/permitted — don't bother
       // the user, but leave a trace for diagnosis.
       console.error('[updater] check failed:', error)
@@ -94,10 +93,9 @@ export function useUpdater() {
         message: `Перезапустити зараз, щоб перейти на версію ${update.version}?`,
         cancel: { label: 'Пізніше', flat: true },
         ok: { label: 'Перезапустити', color: 'primary' },
-        persistent: true,
+        persistent: true
       }).onOk(() => relaunch())
-    }
-    catch (error) {
+    } catch (error) {
       dismiss()
       busy = false
       console.error('[updater] install failed:', error)

package/types/core/dispatch.d.ts

@@ -4,11 +4,14 @@
  * @param {object} [input] candidate input
  * @returns {string|null} error message, or null when valid
  */
-export function validateInput(tool: object, input?: object): string | null;
+export function validateInput(tool: object, input?: object): string | null
 /**
  * Build a dispatch function bound to a catalog and a transport.
  * @param {object[]} catalog tool definitions
  * @param {(tool: object, input: object) => unknown} transport runs the tool's backend call
  * @returns {(name: string, input?: object) => Promise<object>} dispatch returning an envelope
  */
-export function createDispatch(catalog: object[], transport: (tool: object, input: object) => unknown): (name: string, input?: object) => Promise<object>;
+export function createDispatch(
+  catalog: object[],
+  transport: (tool: object, input: object) => unknown
+): (name: string, input?: object) => Promise<object>

package/types/core/manifest.d.ts

@@ -3,24 +3,29 @@
  * @param {Record<string, {type: string, required?: boolean, description?: string}>} input tool input spec
  * @returns {object} JSON Schema for the parameters object
  */
-export function toJsonSchema(input: Record<string, {
-    type: string;
-    required?: boolean;
-    description?: string;
-}>): object;
+export function toJsonSchema(
+  input: Record<
+    string,
+    {
+      type: string
+      required?: boolean
+      description?: string
+    }
+  >
+): object
 /**
  * OpenAI function-calling tool definitions, optionally filtered (e.g. by scope).
  * @param {object[]} catalog tool definitions
  * @param {(tool: object) => boolean} [allow] predicate; default includes all tools
  * @returns {object[]} OpenAI `tools` array
  */
-export function toolManifest(catalog: object[], allow?: (tool: object) => boolean): object[];
+export function toolManifest(catalog: object[], allow?: (tool: object) => boolean): object[]
 /**
  * Compact catalog listing (name + summary).
  * @param {object[]} catalog tool definitions
  * @returns {{name: string, summary: string}[]} tool list
  */
 export function listTools(catalog: object[]): {
-    name: string;
-    summary: string;
-}[];
+  name: string
+  summary: string
+}[]

package/types/core/scope.d.ts

@@ -6,9 +6,14 @@
  * @param {string} toolName tool name
  * @returns {'allow'|'approval'|'deny'} decision
  */
-export function classify(catalog: object[], actorTiers: Record<string, number> | undefined, actor: {
-    kind?: string;
-}, toolName: string): "allow" | "approval" | "deny";
+export function classify(
+  catalog: object[],
+  actorTiers: Record<string, number> | undefined,
+  actor: {
+    kind?: string
+  },
+  toolName: string
+): 'allow' | 'approval' | 'deny'
 /**
  * LLM tool manifest visible to the actor (everything it may run OR request approval for).
  * @param {object[]} catalog tool definitions
@@ -16,9 +21,13 @@ export function classify(catalog: object[], actorTiers: Record<string, number> |
  * @param {{ kind?: string }} actor caller identity
  * @returns {object[]} OpenAI tools array
  */
-export function scopedManifest(catalog: object[], actorTiers: Record<string, number> | undefined, actor: {
-    kind?: string;
-}): object[];
+export function scopedManifest(
+  catalog: object[],
+  actorTiers: Record<string, number> | undefined,
+  actor: {
+    kind?: string
+  }
+): object[]
 /**
  * Tool names visible to the actor.
  * @param {object[]} catalog tool definitions
@@ -26,10 +35,14 @@ export function scopedManifest(catalog: object[], actorTiers: Record<string, num
  * @param {{ kind?: string }} actor caller identity
  * @returns {string[]} visible tool names
  */
-export function scopedToolNames(catalog: object[], actorTiers: Record<string, number> | undefined, actor: {
-    kind?: string;
-}): string[];
+export function scopedToolNames(
+  catalog: object[],
+  actorTiers: Record<string, number> | undefined,
+  actor: {
+    kind?: string
+  }
+): string[]
 export namespace DEFAULT_ACTOR_TIERS {
-    let human: number;
-    let agent: number;
+  let human: number
+  let agent: number
 }

package/types/core/tools.d.ts

@@ -4,4 +4,4 @@
  * @param {string} name tool name
  * @returns {object|null} the tool definition, or null if unknown
  */
-export function getTool(catalog: object[], name: string): object | null;
+export function getTool(catalog: object[], name: string): object | null

package/types/index.d.ts

@@ -1,9 +1,4 @@
-export { createAgentKit } from "./core/agent-kit.js";
-export { getTool } from "./core/tools.js";
-export { handleApprove, handleRequest, handleRespond } from "./core/agent-handler.js";
-export { createDispatch, validateInput } from "./core/dispatch.js";
-export { createOpenAiChat, runAgent } from "./core/llm.js";
-export { listOmlxModels, resolveModel } from "./core/omlx-models.js";
-export { DIRECT_OMLX_BASE_URL, isDirectOmlxUrl, PROXY_OMLX_BASE_URL, resolveOmlxBaseUrl, resolveOmlxBaseUrlCached } from "./core/resolve-omlx-base-url.js";
-export { listTools, toJsonSchema, toolManifest } from "./core/manifest.js";
-export { classify, DEFAULT_ACTOR_TIERS, scopedManifest, scopedToolNames } from "./core/scope.js";
+export { getTool } from './core/tools.js'
+export { createDispatch, validateInput } from './core/dispatch.js'
+export { listTools, toJsonSchema, toolManifest } from './core/manifest.js'
+export { classify, DEFAULT_ACTOR_TIERS, scopedManifest, scopedToolNames } from './core/scope.js'