Skip to content
sort-my-bookmarks

Providers and interfaces

Core types

Section titled “Core types”

Important public types live in src/lib/types.ts.

  • ProviderKind
  • ProviderConfig
  • BookmarkSorterSettings
  • AgentProvider
  • AgentRequest
  • AgentDecision
  • ProcessBookmarkResult
  • ReviewQueueItem
  • EventLogEntry
  • RuntimeMessageMap

Provider implementations

Section titled “Provider implementations”

src/lib/providers.ts currently contains:

  • OpenAiCompatibleProvider
  • AnthropicProvider
  • AzureOpenAiProvider
  • OllamaProvider
  • HeuristicFallbackProvider

Request shapes

Section titled “Request shapes”
  • OpenAI-compatible providers use POST /chat/completions
  • Anthropic uses POST /messages
  • Azure OpenAI uses deployment-specific chat completion URLs
  • Ollama uses POST /api/chat

Safe fallback

Section titled “Safe fallback”

createSafeProvider() returns the heuristic fallback if required configuration is missing or provider creation fails.

Folder resolution

Section titled “Folder resolution”

Folder resolution is now split across focused helpers:

  • bookmark-roots.ts classifies bookmark roots
  • bookmark-tree.ts normalizes titles and path segments
  • bookmark-resolver.ts resolves existing target folders and can prepend a preferred root

Adding a new provider

Section titled “Adding a new provider”
  1. extend ProviderKind
  2. update PROVIDERS and DEFAULT_SETTINGS
  3. extend hasProviderConfiguration()
  4. implement the concrete provider class
  5. wire it into createProvider()