@ouraihub/aether-ui 0.1.0 → 0.1.2

package/src/providers/draft.ts

@@ -88,7 +88,9 @@ export const validUrl = (url: string): boolean => /^https?:\/\/\S+$/.test(url.tr
 export function savable(draft: ProviderDraft): ProviderDraft {
   return {
     ...draft,
-    endpoints: draft.endpoints.filter((e) => e.saved !== null || !e.baseUrl.trim() || validUrl(e.baseUrl)),
+    endpoints: draft.endpoints.filter(
+      (e) => e.saved !== null || !e.baseUrl.trim() || validUrl(e.baseUrl),
+    ),
   }
 }
 
@@ -96,7 +98,11 @@ export function savable(draft: ProviderDraft): ProviderDraft {
  * Takes the stored provider after a save without discarding what the user typed meanwhile:
  * sent endpoints get their stored record (new ones matched by slug); edits stay in the draft.
  */
-export function adopt(current: ProviderDraft, sent: ProviderDraft, stored: Provider): ProviderDraft {
+export function adopt(
+  current: ProviderDraft,
+  sent: ProviderDraft,
+  stored: Provider,
+): ProviderDraft {
   const sentEndpoints = new Map(sent.endpoints.map((endpoint) => [endpoint.slug, endpoint]))
   return {
     ...current,
@@ -105,7 +111,9 @@ export function adopt(current: ProviderDraft, sent: ProviderDraft, stored: Provi
       const original = sentEndpoints.get(endpoint.slug)
       const record =
         original &&
-        stored.endpoints.find((item) => (original.saved ? item.id === original.saved.id : item.slug === original.slug))
+        stored.endpoints.find((item) =>
+          original.saved ? item.id === original.saved.id : item.slug === original.slug,
+        )
       return record ? { ...endpoint, saved: record } : endpoint
     }),
   }
@@ -120,7 +128,9 @@ export function mergeModels(
 ): Model[] {
   const fetched = new Set(probed.map((model) => model.id))
   const existing = new Map(current.map((model) => [model.id, model]))
-  const merged = new Map(current.filter((model) => !fetched.has(model.id)).map((model) => [model.id, model]))
+  const merged = new Map(
+    current.filter((model) => !fetched.has(model.id)).map((model) => [model.id, model]),
+  )
   for (const model of probed) {
     if (!checked[model.id] || merged.has(model.id)) continue
     const previous = existing.get(model.id)
@@ -156,7 +166,8 @@ export function toSave(draft: ProviderDraft): ProviderSave {
       models: e.models.map((model) => {
         const save: ModelSave = {
           ...model,
-          nativeWebSearch: model.modelType === 'chat' && e.protocol !== 'openai-chat' && model.nativeWebSearch,
+          nativeWebSearch:
+            model.modelType === 'chat' && e.protocol !== 'openai-chat' && model.nativeWebSearch,
         }
         // Contract §2: omitted reasoning keeps the stored value, so an untouched (possibly inferred) value is not frozen.
         // Key order matches: edits spread the stored config and append `budgetTokens` last, like serde.
@@ -182,7 +193,13 @@ export const groupKey = (model: Model): string => model.groupName ?? idPrefix(mo
 /** Purpose maps onto existing fields (docs/41 §3.3): edit = image + canVision. */
 export type Purpose = 'chat' | 'image' | 'edit'
 export const purposeOf = (model: Model): Purpose | null =>
-  model.modelType === 'chat' ? 'chat' : model.modelType === 'image' ? (model.canVision ? 'edit' : 'image') : null
+  model.modelType === 'chat'
+    ? 'chat'
+    : model.modelType === 'image'
+      ? model.canVision
+        ? 'edit'
+        : 'image'
+      : null
 export function withPurpose(model: Model, purpose: Purpose): Model {
   const typed = withType(model, purpose === 'chat' ? 'chat' : 'image')
   return purpose === 'chat' ? typed : { ...typed, canVision: purpose === 'edit' }
@@ -191,10 +208,13 @@ export function withPurpose(model: Model, purpose: Purpose): Model {
 export function withType(model: Model, modelType: ModelType): Model {
   if (modelType === model.modelType) return model
   const next: Model = { ...model, modelType, typeSource: 'user' }
-  return modelType === 'chat' ? next : { ...next, reasoning: null, nativeWebSearch: false, pricing: null }
+  return modelType === 'chat'
+    ? next
+    : { ...next, reasoning: null, nativeWebSearch: false, pricing: null }
 }
 
-export type ModelField = 'name' | 'groupName' | 'contextWindow' | 'maxOutput' | 'reasoning' | 'pricing'
+export type ModelField =
+  'name' | 'groupName' | 'contextWindow' | 'maxOutput' | 'reasoning' | 'pricing'
 export interface ModelError {
   field: ModelField
   reason: string
@@ -211,7 +231,8 @@ export function validateModel(model: Model, protocol: Protocol): ModelError[] {
   // Non-integers also fail the backend's integer schema; doc §4.2 shows them as the same `invalid`.
   if (contextWindow !== null && !(Number.isInteger(contextWindow) && contextWindow >= 1))
     add('contextWindow', 'invalid')
-  if (maxOutput !== null && !(Number.isInteger(maxOutput) && maxOutput >= 1)) add('maxOutput', 'invalid')
+  if (maxOutput !== null && !(Number.isInteger(maxOutput) && maxOutput >= 1))
+    add('maxOutput', 'invalid')
   else if (chat && contextWindow !== null && maxOutput !== null && maxOutput >= contextWindow)
     add('maxOutput', 'exceeds_context')
   if (reasoning) {
@@ -234,7 +255,8 @@ export function validateModel(model: Model, protocol: Protocol): ModelError[] {
   }
   if (pricing) {
     const { tiers } = pricing
-    const price = (value: number | null) => value === null || (Number.isFinite(value) && value >= 0 && value <= 1e6)
+    const price = (value: number | null) =>
+      value === null || (Number.isFinite(value) && value >= 0 && value <= 1e6)
     if (
       !chat ||
       !tiers.length ||
@@ -274,7 +296,8 @@ const CHAT_PATH: Record<Protocol, string> = {
   'anthropic-messages': 'messages',
 }
 /** Mirrors `aether_chat::protocol` request paths. */
-export const chatUrl = (baseUrl: string, protocol: Protocol): string => `${apiBase(baseUrl)}/${CHAT_PATH[protocol]}`
+export const chatUrl = (baseUrl: string, protocol: Protocol): string =>
+  `${apiBase(baseUrl)}/${CHAT_PATH[protocol]}`
 
 const HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]{1,100}$/
 const RESERVED_HEADERS: Record<string, true> = {
@@ -289,13 +312,16 @@ const RESERVED_HEADERS: Record<string, true> = {
   'transfer-encoding': true,
   cookie: true,
 }
-export type HeadersError = { key: 'headers_too_many' | 'headers_invalid' } | { key: 'headers_reserved'; name: string }
+export type HeadersError =
+  { key: 'headers_too_many' | 'headers_invalid' } | { key: 'headers_reserved'; name: string }
 
 /** Front-end mirror of the backend header rules (docs/36 §3.3); blank rows are dropped. */
 export function checkHeaders(
   rows: readonly { name: string; value: string }[],
 ): { headers: Record<string, string> } | { error: HeadersError } {
-  const kept = rows.map((r) => ({ name: r.name.trim(), value: r.value })).filter((r) => r.name || r.value)
+  const kept = rows
+    .map((r) => ({ name: r.name.trim(), value: r.value }))
+    .filter((r) => r.name || r.value)
   if (kept.length > 20) return { error: { key: 'headers_too_many' } }
   const headers: Record<string, string> = {}
   const seen = new Set<string>()

package/src/providers/edit-session.ts

@@ -1,4 +1,10 @@
-import { KitClientError, type CallOptions, type ProbeResult, type Provider, type ProvidersPort } from '../ports'
+import {
+  KitClientError,
+  type CallOptions,
+  type ProbeResult,
+  type Provider,
+  type ProvidersPort,
+} from '../ports'
 import { adopt, probeTarget, savable, toSave, type ProviderDraft } from './draft'
 
 export interface ProviderProbeBatch {
@@ -12,14 +18,24 @@ export interface ProviderEditSession {
 }
 
 const cancelled = () =>
-  new KitClientError({ code: 'cancelled', message: 'Provider editing session cancelled', details: {} })
+  new KitClientError({
+    code: 'cancelled',
+    message: 'Provider editing session cancelled',
+    details: {},
+  })
 const identityError = () =>
-  new KitClientError({ code: 'internal', message: 'Saved provider identity is missing or ambiguous', details: {} })
+  new KitClientError({
+    code: 'internal',
+    message: 'Saved provider identity is missing or ambiguous',
+    details: {},
+  })
 // Copy plain DTO data without losing invalid numeric edits or retaining Svelte proxies.
 function snapshot<T>(value: T): T {
   if (Array.isArray(value)) return value.map((item) => snapshot(item)) as T
   if (value !== null && typeof value === 'object')
-    return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, snapshot(item)])) as T
+    return Object.fromEntries(
+      Object.entries(value).map(([key, item]) => [key, snapshot(item)]),
+    ) as T
   return value
 }
 export function createProviderEditSession(
@@ -111,15 +127,23 @@ export function createProviderEditSession(
     const run = async (): Promise<ProviderProbeBatch> => {
       await commit()
       ensureCurrent()
-      const endpoint = snapshot(state.readDraft().endpoints.find((item) => item.slug === slug) ?? null)
+      const endpoint = snapshot(
+        state.readDraft().endpoints.find((item) => item.slug === slug) ?? null,
+      )
       if (!endpoint)
-        throw new KitClientError({ code: 'not_found', message: 'Provider endpoint no longer exists', details: {} })
+        throw new KitClientError({
+          code: 'not_found',
+          message: 'Provider endpoint no longer exists',
+          details: {},
+        })
       const enabled = endpoint.saved?.keys.filter((key) => key.enabled) ?? []
       const keyIds = enabled.length >= 2 ? enabled.map((key) => key.id) : [null]
       const batch: ProviderProbeBatch = { results: [], usable: null }
       for (const keyId of keyIds) {
         ensureCurrent()
-        const result = await port.probe(probeTarget(endpoint, keyId ?? undefined), { signal: controller.signal })
+        const result = await port.probe(probeTarget(endpoint, keyId ?? undefined), {
+          signal: controller.signal,
+        })
         ensureCurrent()
         batch.results.push({ keyId, result })
         if (result.error === null) batch.usable ??= result

package/src/providers/reasoning.ts

@@ -1,6 +1,15 @@
 import type { Protocol, ReasoningEffort, ReasoningDialect, ReasoningConfig } from '../ports'
 
-export const REASONING_EFFORTS: ReasoningEffort[] = ['none', 'auto', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max']
+export const REASONING_EFFORTS: ReasoningEffort[] = [
+  'none',
+  'auto',
+  'minimal',
+  'low',
+  'medium',
+  'high',
+  'xhigh',
+  'max',
+]
 export const REASONING_DIALECTS: ReasoningDialect[] = [
   'openai',
   'anthropic-budget',
@@ -11,13 +20,15 @@ export const REASONING_DIALECTS: ReasoningDialect[] = [
 
 /** Whether `dialect` is written on `protocol` (same rule as the backends). */
 export function dialectFits(dialect: ReasoningDialect, protocol: Protocol): boolean {
-  if (dialect === 'anthropic-budget' || dialect === 'anthropic-adaptive') return protocol === 'anthropic-messages'
+  if (dialect === 'anthropic-budget' || dialect === 'anthropic-adaptive')
+    return protocol === 'anthropic-messages'
   if (dialect === 'openai') return protocol !== 'anthropic-messages'
   return protocol === 'openai-chat'
 }
 
 /** `auto` (on, depth left to the provider) exists only for switch-style dialects. */
-export const allowsAuto = (dialect: ReasoningDialect): boolean => dialect === 'thinking-type' || dialect === 'qwen'
+export const allowsAuto = (dialect: ReasoningDialect): boolean =>
+  dialect === 'thinking-type' || dialect === 'qwen'
 
 export function emptyReasoning(dialect: ReasoningDialect = 'openai'): ReasoningConfig {
   return {
@@ -28,7 +39,10 @@ export function emptyReasoning(dialect: ReasoningDialect = 'openai'): ReasoningC
 }
 
 /** The saved choice if allowed, else the nearest allowed effort (ties go higher); `default` without one. */
-export function nearestEffort(chosen: ReasoningEffort, allowed: readonly ReasoningEffort[]): ReasoningEffort {
+export function nearestEffort(
+  chosen: ReasoningEffort,
+  allowed: readonly ReasoningEffort[],
+): ReasoningEffort {
   if (chosen === 'default' || allowed.includes(chosen)) return allowed.length ? chosen : 'default'
   const at = REASONING_EFFORTS.indexOf(chosen)
   let best: ReasoningEffort = 'default'

package/src/providers/revision.svelte.ts

@@ -1,4 +1,6 @@
 // Bumped after a provider save/remove so open pickers and chat panels reload model capabilities.
 export const providersRevision = $state({ value: 0 })
 /** Model the next `ProvidersSettings` mount opens; set by a chat "open settings" action, cleared once used. */
-export const settingsTarget = $state<{ value: { endpointId: string; modelId: string } | null }>({ value: null })
+export const settingsTarget = $state<{ value: { endpointId: string; modelId: string } | null }>({
+  value: null,
+})

package/src/providers/test-support/providers-fixture.ts

@@ -0,0 +1,120 @@
+import { render } from '@testing-library/svelte'
+import { vi } from 'vitest'
+import { createI18n } from '../../i18n'
+import {
+  createFakePorts,
+  type Endpoint,
+  type Provider,
+  type ProviderPreset,
+  type ProviderSave,
+} from '../../ports'
+import Harness from '../Harness.test.svelte'
+
+export const endpoint: Endpoint = {
+  id: 'e1',
+  slug: 'main',
+  baseUrl: 'http://127.0.0.1:9/v1',
+  protocol: 'openai-chat',
+  keys: [
+    {
+      id: 'k1',
+      label: '',
+      enabled: true,
+      masked: 'sk-a****wxyz',
+      readable: true,
+      exhaustedUntil: null,
+      exhaustedReason: null,
+    },
+  ],
+  keyStrategy: 'round_robin',
+  probeUrl: 'http://127.0.0.1:9/v1/models',
+  imageBaseUrl: null,
+  imageEditBaseUrl: null,
+  headers: { 'X-Team': 'a' },
+  models: [],
+}
+
+export const stored: Provider = {
+  id: 'p1',
+  name: 'Local',
+  enabled: true,
+  notes: '',
+  presetId: null,
+  endpoints: [endpoint],
+}
+
+export const twoKeys: Endpoint = {
+  ...endpoint,
+  keys: [
+    ...endpoint.keys,
+    {
+      id: 'k2',
+      label: 'backup',
+      enabled: true,
+      masked: 'sk-b****1234',
+      readable: true,
+      exhaustedUntil: null,
+      exhaustedReason: null,
+    },
+  ],
+}
+
+export const model = {
+  name: null,
+  groupName: null,
+  pricing: null,
+  contextWindow: null,
+  maxOutput: null,
+  canVision: false,
+  supportsTools: null,
+  nativeWebSearch: false,
+} as const
+
+export function setup(
+  overrides: NonNullable<Parameters<typeof createFakePorts>[0]>['providers'] = {},
+  list = stored,
+  presets?: ProviderPreset[],
+) {
+  const saves: ProviderSave[] = []
+  const ports = createFakePorts({
+    providers: {
+      list: () => Promise.resolve([list]),
+      save: (input) => {
+        saves.push(input)
+        return Promise.resolve([stored])
+      },
+      probe: () =>
+        Promise.resolve({
+          probeUrl: endpoint.probeUrl,
+          error: null,
+          suggestedProtocol: null,
+          models: [
+            {
+              ...model,
+              id: 'gpt-4o',
+              group: 'gpt',
+              modelType: 'chat',
+              typeSource: 'inferred',
+              reasoning: null,
+            },
+            {
+              ...model,
+              id: 'text-embedding-3',
+              group: null,
+              modelType: 'embedding',
+              typeSource: 'inferred',
+              reasoning: null,
+            },
+          ],
+        }),
+      ...overrides,
+    },
+  })
+  const notify = { toast: vi.fn(), confirm: () => Promise.resolve(true) }
+  const logger = { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() }
+  render(Harness, {
+    kit: { ports, i18n: createI18n('en'), notify, logger },
+    ...(presets ? { presets } : {}),
+  })
+  return { saves, notify }
+}

package/src/search/SearchAdvancedTools.svelte

@@ -0,0 +1,182 @@
+<script lang="ts">
+  import { Button } from '#lib/components/ui/button/index.js'
+  import { Input } from '#lib/components/ui/input/index.js'
+  import { Textarea } from '#lib/components/ui/textarea/index.js'
+  import * as Field from '#lib/components/ui/field/index.js'
+  import { getKitContext } from '../context'
+  import type { SearchPage, SearchPreferences, SearchResult } from '../ports'
+  let {
+    preferences = $bindable(),
+    blacklist = $bindable(),
+    query = $bindable(),
+    pageUrl = $bindable(),
+    preferencesPending,
+    preferencesError,
+    result,
+    page,
+    queryPending,
+    pagePending,
+    queryError,
+    pageError,
+    onSavePreferences,
+    onSearch,
+    onReadPage,
+  }: {
+    preferences: SearchPreferences
+    blacklist: string
+    query: string
+    pageUrl: string
+    preferencesPending: boolean
+    preferencesError: string
+    result: SearchResult | null
+    page: SearchPage | null
+    queryPending: boolean
+    pagePending: boolean
+    queryError: string
+    pageError: string
+    onSavePreferences: () => void
+    onSearch: () => void
+    onReadPage: () => void
+  } = $props()
+
+  const { i18n } = getKitContext()
+  const { t } = i18n
+  const safeUrl = (raw?: string) => {
+    if (!raw) return null
+    try {
+      const url = new URL(raw)
+      return ['https:', 'http:'].includes(url.protocol) ? url.href : null
+    } catch {
+      return null
+    }
+  }
+</script>
+
+<section class="rounded-kit border p-4">
+  <details>
+    <summary class="cursor-pointer text-kit-base font-semibold">{t('search.advanced')}</summary>
+    <Field.Group class="mt-3 gap-3">
+      <Field.Field orientation="horizontal"
+        ><Field.Label for="search-max-results">{t('search.maxResults')}</Field.Label><Input
+          id="search-max-results"
+          class="ml-auto w-20"
+          type="number"
+          min="1"
+          max="50"
+          disabled={preferencesPending}
+          value={preferences.maxResults}
+          oninput={(event) => (preferences.maxResults = +event.currentTarget.value)}
+        /></Field.Field
+      >
+      <Field.Field orientation="horizontal"
+        ><Field.Label for="search-compression">{t('search.compression')}</Field.Label><select
+          id="search-compression"
+          class="bg-background border-input h-kit-control ml-auto rounded-kit-sm border px-2 text-kit-sm"
+          disabled={preferencesPending}
+          value={preferences.compression}
+          onchange={(event) =>
+            (preferences.compression = event.currentTarget
+              .value as SearchPreferences['compression'])}
+          ><option value="none">{t('search.compressionNone')}</option><option value="cutoff"
+            >{t('search.compressionCutoff')}</option
+          ></select
+        ></Field.Field
+      >
+      {#if preferences.compression === 'cutoff'}<Field.Field orientation="horizontal"
+          ><Field.Label for="search-cutoff">{t('search.cutoffLimit')}</Field.Label><Input
+            id="search-cutoff"
+            class="ml-auto w-24"
+            type="number"
+            min="100"
+            max="20000"
+            disabled={preferencesPending}
+            value={preferences.cutoffLimit}
+            oninput={(event) => (preferences.cutoffLimit = +event.currentTarget.value)}
+          /></Field.Field
+        >{/if}
+      <Field.Field
+        ><Field.Label for="search-blacklist">{t('search.blacklist')}</Field.Label><Textarea
+          id="search-blacklist"
+          rows={3}
+          disabled={preferencesPending}
+          placeholder="example.com\n*://*.example.org/*"
+          value={blacklist}
+          oninput={(event) => (blacklist = event.currentTarget.value)}
+        /></Field.Field
+      >
+    </Field.Group>
+  </details>
+  <Field.Field class="mt-3 border-t pt-3"
+    ><label class="flex items-center gap-2 text-kit-sm"
+      ><input
+        type="checkbox"
+        disabled={preferencesPending}
+        checked={preferences.modelToolsPreferred}
+        onchange={(event) => (preferences.modelToolsPreferred = event.currentTarget.checked)}
+      />{t('search.nativePreferred')}</label
+    ><Field.Description>{t('search.nativePrivacy')}</Field.Description></Field.Field
+  >
+  {#if preferencesError}<p role="alert" class="text-destructive text-kit-sm">
+      {preferencesError}
+    </p>{/if}
+  <Button
+    class="mt-3"
+    type="button"
+    size="sm"
+    disabled={preferencesPending}
+    onclick={onSavePreferences}>{t('search.save')}</Button
+  >
+</section>
+<section class="flex min-w-0 flex-col gap-3 rounded-kit border p-4" aria-label={t('search.tools')}>
+  <Field.Field
+    ><Field.Label for="search-query">{t('search.query')}</Field.Label>
+    <div class="flex min-w-0 gap-2">
+      <Input
+        id="search-query"
+        class="min-w-0 flex-1"
+        disabled={queryPending}
+        value={query}
+        oninput={(event) => (query = event.currentTarget.value)}
+      /><Button type="button" disabled={queryPending || !query.trim()} onclick={onSearch}
+        >{t('search.runSearch')}</Button
+      >
+    </div></Field.Field
+  >
+  {#if queryError}<p class="text-destructive text-kit-sm" role="alert">{queryError}</p>{/if}
+  {#if result}<p class="text-muted-foreground text-kit-sm">
+      {t('search.resultCount', { count: result.hits.length })}
+    </p>
+    {#each result.hits as hit (hit.url)}<article class="min-w-0 text-kit-sm">
+        <a
+          class="text-primary break-words hover:underline"
+          href={safeUrl(hit.url) ?? ''}
+          target="_blank"
+          rel="noopener noreferrer">{hit.title}</a
+        >
+        <p class="whitespace-pre-wrap break-words">{hit.snippet}</p>
+      </article>{/each}{/if}
+  <Field.Field
+    ><Field.Label for="search-page-url">{t('search.pageUrl')}</Field.Label>
+    <div class="flex min-w-0 gap-2">
+      <Input
+        id="search-page-url"
+        class="min-w-0 flex-1"
+        disabled={pagePending}
+        value={pageUrl}
+        oninput={(event) => (pageUrl = event.currentTarget.value)}
+      /><Button type="button" disabled={pagePending || !pageUrl.trim()} onclick={onReadPage}
+        >{t('search.read')}</Button
+      >
+    </div></Field.Field
+  >
+  {#if pageError}<p class="text-destructive text-kit-sm" role="alert">{pageError}</p>{/if}
+  {#if page}<h3 class="text-kit-base font-medium">{page.title}</h3>
+    <a
+      class="text-primary break-words text-kit-sm"
+      href={safeUrl(page.url) ?? ''}
+      target="_blank"
+      rel="noopener noreferrer">{page.url}</a
+    >
+    <pre
+      class="max-h-96 overflow-auto whitespace-pre-wrap break-words text-kit-sm">{page.content}</pre>{/if}
+</section>