Store a single dialog turn in persistent session memory.

Persists a message (user, assistant, system, or tool) for later retrieval and context assembly. Metadata can hold arbitrary JSON-serializable context such as model name, tool calls, or review state.

Args: session_id: Unique conversation session identifier. role: Speaker role (e.g. user, assistant, system). content: Message text content. metadata: Optional key-value context attached to this turn.

Returns: JSON string with the stored turn record including assigned id.

Retrieve the most recent dialog turns for a session.

Returns turns in chronological order (oldest first) so they can be directly used as LLM context.

Args: session_id: Conversation session to query. limit: Maximum number of recent turns to return (default 10).

Returns: JSON string with session id, turn count, and turn list.

Search dialog memory within a session by text substring.

Performs a case-insensitive LIKE search over turn content and roles. Suitable for finding earlier mentions of topics, decisions, or entities.

Args: session_id: Conversation session to search. query: Substring to match in content or role. limit: Maximum results to return (default 20).

Returns: JSON string with matching turns, newest first.

Recommend the best AI provider for a given task type.

Uses the public kbarbel640-del/ai-provider-registry to score providers by capability match, free-tier preference, and known provider strengths.

Args: task_type: Task category — chat, code, reasoning, vision, search, embeddings, image, or tools. constraints: Optional routing constraints: - prefer_free (bool): Prefer free-tier providers. - exclude_providers (list[str]): Provider ids to skip. - api_style (str): Required API style (e.g. openai).

Returns: JSON string with top recommendation and up to four alternatives.

List all providers from the AI Provider Registry.

Fetches the live registry document and returns provider summaries including id, api_style, free-tier status, and supported capabilities.

Returns: JSON string with registry metadata and provider list.