Crate soma_palette 

soma-palette — Soma’s Palette product API and adapter.

Owns the /v1/palette/* route/handler definitions ([module router]), the Palette DTOs shared by the HTTP server and the desktop app, the product mapping from provider ToolSpec Palette overlays into launcher actions, product launcher execution/auth policy, product error mapping, and product OpenAPI route metadata. Does not own Tauri window/tray/shortcut mechanics (see soma-tauri-shell), tauri.conf.json/bundle metadata, or frontend code — those stay in apps/palette.

As of this crate’s introduction (PR 17), router() is not yet mounted into apps/soma’s HTTP server — that wiring lands in a follow-up PR. This crate is buildable and independently tested (see router_tests.rs) ahead of that mount.

See soma-architecture-refactor-plan-v3.md section 3.25 and “PR 17”.

Re-exports

pub use dto::LauncherCatalogEntry;

pub use dto::LauncherCatalogResponse;

pub use dto::LauncherExecuteRequest;

pub use dto::LauncherExecuteResponse;

pub use dto::LauncherSchemaQuery;

pub use dto::LauncherSchemaResponse;

pub use dto::LauncherSearchQuery;

pub use dto::LauncherSearchResponse;

pub use router::router;

pub use state::PaletteState;

Modules

auth

Product auth/session behavior for Palette requests.

catalog

Product mapping from provider ToolSpec / Palette overlays into Palette launcher actions, plus in-memory search over the mapped catalog.

dto

Palette DTOs shared by the Soma HTTP server and the desktop app.

error

Product error mapping for Palette UI responses.

execute

Product launcher execution and auth policy for POST /v1/palette/execute.

openapi

Product OpenAPI route metadata for /v1/palette/*.

router

/v1/palette/* route wiring.

schema

Schema lookup for a single Palette launcher action.

search

In-memory search over the mapped Palette catalog.

state