ollmchat

---

Description:

OLLMchat API - Package Overview

This documentation covers the OLLMchat application and its libraries.

Application

* libollmapp — namespace: OLLMapp. Main application: window, settings dialogs. Entry point and window management.

• SettingsDialog — MainDialog, ConnectionsPage, ModelsPage, ProjectsPage, ToolsPage. Rows — row widgets for settings.

Core libraries

* libollmchat — namespace: OLLMchat. LLM chat client: Ollama/OpenAI-compatible API, tool calling, streaming, history, and configuration without GTK.

• Client — API communication and chat entry point. Message — chat message representation.
• Call — API call implementations. Base, Chat, Embed, Models, Create, Delete, Pull, Version.
• Response — Response types for API results. Base, Chat, CallFunction, ToolCall.
• Tool — Function calling (tools, params, requests). BaseTool, Function, Param, RequestBase.
• History — Session persistence and list. Manager, Session, SessionBase.
• Settings — Configuration (connections, models, usage). Connection, Config2 , ConnectionModels , ModelUsage.
• Agent — Agent interface and implementations. Interface, Base, Factory, JustAsk, JustAskFactory.
• Prompt — Prompt templates for agents. Template.
• ChatPermission — Permission provider for tool access. Provider, Dummy.

* liboctools — namespace: OLLMtools. Built- in tools; registered via Tool and used by the chat/agent stack.

• ReadFile — Read file contents. Tool, Request.
• WriteFile — Write file contents. Tool, Request.
• RunCommand — Run shell commands. Tool, Request.
• WebFetch — Fetch URLs. Tool, Request.
• GoogleSearch — Web search. Tool, Config.
• CodebaseSearch — Semantic codebase search. Tool, Request.
• HuggingFace — Hugging Face model search and download. Tool , Request.
• Child — Child/sub-agent tool. Tool, Agent, Factory.
• EditMode — Edit-in-place streaming. Tool, Stream.
• Registry — Tool registration.

* libocfiles — namespace: OLLMfiles. File and project management: buffers, files, folders, project list, tree-sitter AST paths, diff/patch.

• File, Folder, FileBase, FileBuffer, ProjectManager, ProjectFiles, Tree, TreeBase. Patch, Differ.

* libollmchatgtk — namespace: OLLMchatGtk . Chat widget, history browser, tool permission UI, model usage list. Application-facing GTK pieces.

• ChatWidget — main chat container. ChatView — message display. ChatInput — input area. ChatBar — top bar. HistoryBrowser — session list. ChatPermission — permission UI.
• List — Model usage list/filter/sort. ModelUsageFilter, ModelUsageSort, ModelUsageFactory, SortedList. Tools — Tool permission UI. Permission.

RPC and daemons

* libocrpc — namespace: OLLMrpc. Binary RPC client and wire types for ollmfilesd (Unix socket / stdio / TCP) and HTTPS JSON APIs. Overview and usage examples on the namespace page.

• Client — connect and call. Request / Response — envelopes. CallParam — typed params. Bin — Serializable, Stream, Json. Transport — daemon listen/connection. Live — live handles (Remote, Subscribe, Buffer, BufferListen).

* ollmfilesd — namespace: OLLMfilesd. Headless file and semantic-index daemon (RPC over stdio or TCP).

Semantic search

* libocfiles (vector metadata) — namespace: OLLMfiles.SQT. SQLite vector metadata used by the file daemon and codebase search.

• VectorMetadata — per- chunk embedding metadata rows.

Hugging Face and Ollama web

* libochf — namespace: OLLMhf. Hugging Face Hub model catalog (search, detail, GGUF download).

• Model, ModelArray, Download. Param — search query params.

* libollamaweb — namespace: OllamaWeb. Live search and model metadata from ollama.com.

• Search — Client, Service, Model.

MCP and sandboxing

* libocmcp — namespace: OLLMmcp. MCP (Model Context Protocol) client: load servers, discover tools, expose as agent tools.

• Loader, Registry, Tool. Client — stdio and HTTP transports.

* libocbwrap — namespace: OLLMbwrap. Bubblewrap overlay and seccomp sandboxing for tool execution.

• Bubble, Overlay, RunSeccomp, Scan.

Markdown parsing and rendering

* libocmarkdown — namespace: Markdown. Markdown parsing and document model. Used by skills and chat rendering.

• Parser — Parse markdown. RenderBase — Base renderer.
• Document — Document tree (nodes, blocks, format). Document, Block, Node, Format, List, Render.

* libocmarkdowngtk — namespace: MarkdownGtk . GTK markdown rendering for the chat UI.

Coding and Skills

* liboccoder — namespace: OLLMcoder. Code- editor and task/skill layer: skills, tasks, GTK source view. Skill-based task creation, refinement, and execution.

• Skill — Skill definitions, runner, manager, templates. Runner, Manager, Factory, Definition, PromptTemplate.
• Task — Task list, details, tool runs, steps, result parsing. List, Details, Tool, Step, ResultParser.
• Agent — Coding agent. AgentFactory — Factory. SourceView — Code editor widget.

Database

* libocsqlite — namespace: SQ. SQLite wrapper. Used by libocfiles and vector metadata.

• Database — DB connection. Query — Prepared statements. Schema — Schema definition.

Reference

• Vala — Vala language site (external).

Content:

Namespaces:

• Markdown

Classes:

• BlockMap - Marker map for block-level markers (headings, HR, lists, fenced code, blockquote, etc.). Used by the parser for handle_block_result().
• DummyRenderer - Dummy renderer for testing the Parser. Extends RenderBase and overrides methods to print callbacks instead of rendering.
• EndMap - Marker map for delimiter runs that are valid at **end of line** ("?_"). Used when the run is at end of line (closing delimiter). Contains only emphasis-style sequences (asterisk and underscore); no links, code, etc. No integration with parser yet - structure only.
• FormatMap - Marker map for inline format markers (bold, italic, code, etc.). Used by the parser for format detection via eat().
• HtmlParser - Converts HTML to Markdown format.
• HtmlRender - Simple renderer that converts markdown to HTML strings.
• LeftMap - Marker map for delimiter runs that are valid as opening delimiters (must be preceded by whitespace). peek() wraps eat() and fails if at line start or the character before is not whitespace. Contains only emphasis-style sequences (asterisk and underscore); no links, code, etc.
• ListMap - Marker map for list-only block markers (CONTINUE_LIST, ORDERED_LIST, UNORDERED_LIST). Used by the parser (via BlockMap.peek) for list-block detection.
• MarkerMap - Base class for marker maps used by the parser. Holds an instance map and provides generic peek logic for matching variable-length marker sequences at a given position.
• PangoRender - Simple renderer that converts markdown and HTML tags to Pango markup strings.
• Parser - Parser for markdown text that calls specific callbacks on Render.
• RenderBase - Base abstract class for renderers that use the Parser.
• RightMap - Marker map for delimiter runs that are valid as closing delimiters (must be followed by whitespace or newline). peek() wraps eat() and rejects the match if the next character is not whitespace or newline. Contains only emphasis-style sequences (asterisk and underscore); no links, code, etc.
• StartMap - Marker map for delimiter runs that are valid at **start of line** only. Used when the preceding context is "start of line" (e.g. at_line_start). Contains only emphasis-style sequences (asterisk and underscore); no links, code, etc.
• Writer - Handles markdown output writing.

Enums:

• FormatType

Methods:

• public void sax_end_document (void* ctx)
  SAX callback: End of document.
• public void sax_end_element (void* ctx, string name)
  SAX callback: End element.
• public void sax_start_document (void* ctx)
  SAX callback: Start of document.
• public void sax_start_element (void* ctx, string name, string[] attrs)
  SAX callback: Start element.
• Document

Classes:

• Block
• Document
• Format
• List
• ListItem
• Node
• Render
• MarkdownGtk

Classes:

• Render - Renders markdown content to a Gtk.TextBuffer using a state-based renderer.
• RenderBox - Vertical Gtk.Box used as the live markdown row target for Render.
• RenderSourceView - Handles SourceView widget creation and management for code blocks.
• State - Represents a single piece of styling in the markdown renderer.
• TopState - Extends State to handle special root state behavior.
• OLLMapp

Interfaces:

• ChatUserInterface - Shared chat shell for desktop and Android main windows (ollmapp only).

Classes:

• About - About button widget that shows an Adw.AboutWindow when clicked. Self-contained component that handles its own dialog.
• ActivityBanner - Header status bar for daemon activity (filesystem scan, vector index, etc.).
• AgentDropdown - Agent picker for the chat header (Gtk.DropDown is sealed).
• BusyDialog - Modal spinner with a status line (startup, connection checks, etc.).
• FileChangeBanner - Banner widget that displays file change warnings with action buttons.
• Initialize - Handles application initialization and verification.
• OllmchatApplication - Main application class implementing OLLMchat.ApplicationInterface interface.
• OllmchatWindow
• WindowPane - Window pane utility class that manages a split view with special resizing behavior.
• SettingsDialog

Classes:

• AddModelDialog - Dialog for adding models by selecting from available models list.
• ConnectionAdd - Dialog for adding connections.
• ConnectionRow - Widget group for a single connection row in the connections page.
• ConnectionsPage - Connections tab content for settings dialog.
• MainDialog - Main settings dialog for displaying and changing configuration.
• ModelRow - Model row widget that extends Adw.ExpanderRow.
• ModelsPage - Models tab content for settings dialog.
• ProjectSearchFilter - Gtk.Filter for projects list: filters by project name (basename) or full path. Case-insensitive substring match. Emits changed when query is set.
• ProjectsPage - Projects tab content for settings dialog. Lists projects from ProjectManager, search/filter, Add and Remove. List view is built in the constructor with a dummy empty model; the real store is bound when the dialog is shown via ensure_loaded() (called once).
• PullManager - Manages background pull operations for models.
• PullManagerBanner - Banner widget that displays pull progress information.
• PullStatus - Pull status information for a model pull operation.
• SearchablePulldown - Simple string-based searchable dropdown widget.
• SettingsPage - Base class for settings dialog pages.
• SkillsPage - Settings tab: Agent Pi skills available vs initially offered.
• ToolsPage - Tools tab content for settings dialog.
• Rows

Classes:

• Bool - Widget class for bool properties.
• Connection - Widget class for connection properties.
• Float - Generic float option widget that extends Row.
• Int - Generic int option widget that extends Row.
• Model - Widget class for model properties.
• ModelUsage - Widget class for ModelUsage properties.
• Options - Widget that contains all option rows for model configuration.
• Row - Base class for all config widget classes.
• SkillRow - One Agent Pi skill settings row: ActionRow, offered Switch, and Skill.
• String - Widget class for string properties.
• Tool - Tool row widget that extends Adw.ExpanderRow.
• OLLMbwrap - Shared bubblewrap / overlay / seccomp sandbox stack (`libocbwrap`).

Interfaces:

• FileVerification - Applies overlay scan results to the live filesystem and project index.

Classes:

• Bubble - Bubble class for executing commands in bubblewrap sandbox.
• NoOpFileVerification - No-op FileVerification for callers that never run overlay scan.
• Overlay - Overlay filesystem creation, directory layout, and cleanup for sandbox runs.
• RunSeccomp - Seccomp user-notify setup and aggregation for a single bubblewrap run.
• Scan - Post-completion overlay scanner: walk the upper layer and delegate apply to FileVerification.
• OLLMchat - LLM chat client namespace.

Interfaces:

• ApplicationInterface - Interface for OLLMchat applications that provides standardized configuration and data directory management.
• ChatContentInterface - Interface for objects that provide chat content.
• ChatDesktopInterface - Desktop host surface for coder and skill Agent.Factory activate / deactivate.

Classes:

• Client - Main client class for interacting with Ollama API and OpenAI-compatible REST interfaces.
• Message - Message class for chat conversations with role-based behavior.
• MessageQueue - Mid-run queue of Message rows as a GLib.ListModel.

Error domains:

• OllmError

Fields:

• public bool debug_critical_enabled
  Enable treating critical warnings as errors (abort on critical warnings). Set to true to cause the program to abort on critical warnings.
• public bool debug_on
  Enable debug output (show all log messages). Set to true to see all log messages, false to only see critical warnings.
• Agent - Agent system namespace.

Interfaces:

• Interface - Interface for agent implementations.

Classes:

• Base - Base handler for agent requests.
• Factory - Base class for agent factories.
• JustAsk - Just Ask agent - a simple pass- through agent.
• JustAskFactory - Just Ask factory - creates simple pass-through agents.
• Summarizer - Background conversation summarizer for agents with summary history.
• Call - API call implementations namespace.

Classes:

• Base - Abstract base class for all Ollama API calls.
• Chat - Chat API call implementation for sending messages and receiving responses.
• ChatBase - Shared chat call surface: state, signals, and tool recursion helpers. Subclasses implement send for protocol-specific request paths.
• ChatCompletions - OpenAI-compatible chat completions API call.
• Completions - OpenAI-compatible completions API call (prompt → text). Uses v1/completions; same URL pattern as Call.Models. Request: model, prompt (required), optional max_tokens, temperature, top_p, n, stop, presence_penalty, frequency_penalty. Options: same Call.Options as Generate; used as fallback when top-level param not set (options.num_predict → max_tokens, etc.). Returns Response.Generate; v1 JSON is parsed via deserialize_property.
• Create - API call to create a model using the Ollama create API endpoint.
• Delete - API call to delete a model from the Ollama server.
• Embed - API call to generate embeddings for input text.
• Embeddings - OpenAI-compatible embeddings API call. Uses v1/embeddings; same URL pattern as Call.Models. Request: model, input (string array). Returns Response.Embed (v1 response parsed into Embed).
• Generate - API call to generate a response for a prompt.
• Models - API call to list available models (OpenAI-compatible).
• Options - Options object for Ollama API calls.
• Ps - API call to list currently running models on the Ollama server.
• Pull - API call to pull a model from the Ollama server.
• ReplayChat - Chat implementation that returns replayed content instead of calling the LLM. Takes the raw message list; each send() returns the next relevant message's content, skipping roles that are not LLM content (e.g. ui, system, project). Used by tests to drive the real Runner/List flow with session messages.
• ShowModel - API call to get detailed information about a specific model.
• Version - API call to get the version of the Ollama server.
• CallLocal

Interfaces:

• Thread - Shared per-call threading for local GGUF inference.
• ChatPermission - Tool permission system namespace.

Classes:

• Dummy - Dummy implementation of Provider for testing.
• Provider - Abstract base class for requesting permission to execute tool operations.

Enums:

• Operation - Operation types for permission requests. Can be combined using bitwise OR (e.g., READ | WRITE).
• PermissionResponse - Permission response from user. Combines allow/deny decision with storage type.
• PermissionResult - Permission check result.
• Chatter - Chatter agent namespace.

Classes:

• Agent - Chatter agent.
• Factory - Factory for the Chatter agent.
• PendingMessage - One queued chat or summarize step. run relays by is_chat; queue drain lives on Agent.send_async.
• History - Chat history and session management namespace.

Classes:

• EmptySession - EmptySession represents a session that hasn't started yet (no messages sent).
• Manager - Manager for chat history persistence.
• Session - Session is a wrapper around Call.Chat that provides history persistence.
• SessionBase - Base class for Session implementations.
• SessionJson - SessionJson is used only for loading messages from JSON files.
• SessionList - Manages session list with deduplication and fast lookup.
• SessionPlaceholder - SessionPlaceholder represents a chat session loaded from the database but without the chat connected or messages loaded.
• TitleGenerator - Generates concise titles for chat conversations using LLM.
• Prompt - Prompt generation and agent system namespace.

Classes:

• Template - Base prompt template: load from resource URI or filesystem, fill placeholders. Subclasses set source and base_dir (e.g. GResource URI resource: plus /ocvector, or filesystem path).
• Response - API response handling namespace.

Classes:

• Base - Abstract base class for Ollama API responses.
• CallFunction - Represents a function call with name and arguments. Used within ToolCall to represent the function being called.
• Chat - Response from a chat API call.
• Chunk - One NDJSON line or v1 SSE payload deserialized from the wire.
• Create - Represents a progress chunk from the create API.
• Embed - Represents the response from the embeddings API.
• EmbeddingDatum - One embedding in an OpenAI embeddings response. embedding (array of doubles), index.
• EmbeddingList - Top-level OpenAI embeddings response. object, data (array of EmbeddingDatum), model, optional usage.
• FloatArray - Stores multiple vectors in a flat array (row-major). Used for embedding API responses and batch FAISS operations. All vectors must have the same width (dimension).
• Generate - Represents the response from the generate API.
• Model - Represents model information from the Ollama server.
• Pull - Represents a progress chunk from the pull API.
• ToolCall - Represents a tool call from the assistant. Used in assistant messages with tool_calls array.
• Usage - Token usage from an OpenAI API response. Used in chat completions and embeddings responses.
• Settings - Configuration and settings namespace.

Interfaces:

• RequiresModelsInterface - Interface for tool configs that require models to be available at startup.

Classes:

• AgentConfig - Per-agent settings for Config2.
• BaseToolConfig - Base configuration class for simple tools that only need enabled/disabled.
• Config2 - Main serializable configuration holder for version 2 format (multiple clients, extended structure).
• Connection - Represents a single server connection configuration.
• ConnectionModels - Manages the list of available models from all configured connections.
• ModelUsage - Represents model usage configuration (connection, model, and optional options).
• SearchResults - Live ollama.com search backing store for Add Model (GLib.ListModel of OllamaWeb.Model).
• Window - Per-window open project, file, and agent persisted in Config2.
• Tool - Tool interface and parameter system namespace.

Interfaces:

• UiWidgets - Optional chrome for a tool: toggle metadata, host view, and show request.
• WrapInterface - Interface for tools that can be wrapped by other tools.

Classes:

• BaseTool - Abstract base class for tools that can be used with Ollama function calling.
• Function - Concrete class representing a function within a Tool.
• Param - Abstract base class for parameter definitions.
• ParamArray - Represents an array parameter with items definition.
• ParamObject - Represents an object parameter with nested properties.
• ParamParser - Parser for tool definition text containing descriptions and annotations.
• ParamSimple - Represents a simple parameter type (string, integer, boolean).
• RequestBase - Abstract base class for tool request execution.
• OLLMchatGtk

Classes:

• ChatBar - Chat bar widget: model dropdown and play/Stop action button. ChatWidget creates this and places it in the lower box with the permission widget.
• ChatInput - Chat composer: one expanding TextView with play on the right when single-line; play moves to ChatBar when text needs a second line.
• ChatPermission - Permission widget that displays permission requests with buttons.
• ChatView - Chat view widget for displaying chat messages with markdown rendering.
• ChatWidget - Reusable chat widget that can be embedded anywhere in the project.
• HistoryBrowser - History browser widget that displays a list of past chat sessions.
• MessageQueueView - Pending mid-run queue strip: Gtk.ColumnView over a OLLMchat.MessageQueue (text | pencil | up/urgent).
• ScrolledView - App-owned vertical scroll shell (GTK Gtk.ScrolledWindow model, without fighting measure).
• List

Classes:

• ModelUsageFactory - Factory for creating list items from ModelUsage objects.
• ModelUsageFilter - Filter for ModelUsage objects by connection URL.
• ModelUsageSort - Sorter for ModelUsage objects by model family name.
• SortedList - A sorted and filtered list model for any type of object.
• Tools

Classes:

• Permission - Permission provider that displays permission requests using ChatWidget's permission widget.
• OLLMcoder - GTK-based code editor components namespace.

Classes:

• Agent - Handler for CodeAssistant agent requests.
• AgentFactory - Code Assistant factory.
• Approvals - Horizontal box widget containing buttons for file approval workflow.
• BufferProvider - GTK implementation for GUI contexts.
• FileDropdown - Searchable dropdown widget for selecting files.
• GtkSourceFileBuffer - GTK SourceView buffer implementation for GUI contexts.
• ProjectDropdown - Searchable dropdown widget for selecting projects.
• SearchableDropdown - Base class for searchable dropdown widgets.
• SourceView - Source view component with code editor.
• Action

Classes:

• Base - Base for task execution runners (lifted from Task.Details.run_exec / Task.Details.run_post_exec). Extraction wired; run dispatch — plan 7.16.1b.
• ExamSequence - Path A — examination references: run each exam Task.Tool, then merge when N > 1. Copied from Task.Details.run_exec.
• PostExamMerge - Post-execution synthesis when the execution queue has more than one run. Copied from Task.Details.run_post_exec and Task.Details.post_exec_prompt.
• RefOnly - Path C — shared references only: lone exec Task.Tool, copy executor output. Copied from Task.Details.run_exec.
• RunTools - Path B — run each Task.Tool in the execution queue, then merge when N > 1. Copied from Task.Details.run_exec. Removed in plan 7.16.3 when Iterate ships.
• WriteExec - Path D — write skills: lone exec Task.Tool (write_file handled inside Task.Tool.run). Copied from Task.Details.run_exec.
• AgentPi - Agent Pi — Pi-like free-form coding agent.

Classes:

• Agent - Agent Pi session agent.
• Factory - Factory for Agent Pi (id agent -pi).
• PendingMessage - One queued chat deliver for Agent.
• Skill - One Pi-format soft skill (Agent Skills SKILL.md entry).
• SkillSet - Scan Pi-format skill directories and format the Agent Pi catalog.
• List

Classes:

• SortedList - A sorted and filtered list model for any type of object.
• Skill

Classes:

• Definition - One skill file: YAML header, then Refinement and Execution sections separated by "---". Constructor only stores path; call load() to read and parse. Header is stored in a hash map after load.
• Factory - Lightweight factory: creates Manager and Runner only. Message building lives in Runner.
• Manager - Loads built-in skills from gresources and optional user overrides under ~/.local/share/ollmchat/skills/.
• PromptTemplate - Prompt template that loads from the skill-prompts resource only (no filesystem).
• Runner - Agent that runs a single skill. Builds system message (template + available skills + current skill) and user message (template or pass-through); injects them and sends.
• Task

Interfaces:

• ProgressItem - Row surface for the task progress UI (ProgressList).

Classes:

• Details - One task in the plan. Built from task list output; updated from refinement output.
• List - Ordered list of task steps produced by planning; runs refinement and execution.
• ProgressList - GLib.ListModel of ProgressItem rows: Details from completed work, zero or more ProgressRunner rows (e.g. one for task creation and one for iteration — each PhaseEnum.COMPLETED when that slice is done), pending Details from runner.pending. A Step uses PhaseEnum.COMPLETED_DONE once it lives on runner.completed. GLib.ListModel.get_item_type returns typeof(ProgressItem).
• ProgressRunner
• ProgressView - Read-only task progress strip: collapse header (“Skill activity”) plus Gtk.Revealer around Gtk.ScrolledWindow / Gtk.ColumnView. Default collapsed; #set_runner keeps the grid hidden when progress data binds. Gtk.TreeListModel auto-expand applies to row children only. Call #set_runner for Skill.Runner.progress.
• ResolveLink - Turns validated task reference links into fenced markdown blocks for prompts: task docs, #anchors in the user request, http(s) from cache, and file excerpts (line range, full file, or AST path after preload_links parsed the tree). Used from Details.reference_contents, refine(), and Tool.run after preload.
• ResultParser - Parses structured markdown responses from the LLM into task data and results.
• Step - One unit of the task list: either a single task or a concurrent group.
• Tool - Parsed tool call (refinement) and/or one execution run.
• ToolList - List of Tool rows for one Details . Backing store for ProgressItem.children on Details once **7.14.1.3** wires the execution queue; implements GLib.ListModel, Gee.Iterable, and Gee.Traversable so call sites can foreach over tools.
• ValidateLink - Reference-link validation for task references (used from ResultParser and similar).
• WriteChange - One write operation parsed from a write-executor heading section (e.g. Change details).

Enums:

• PhaseEnum - Which task-list or executor phase is active for markdown generation, link validation, and (on restore) transcript replay.
• OLLMfiles - File and project management namespace.

Interfaces:

• Copyable - GObject types that copy writable properties from another instance.
• FileBuffer - Interface for file buffer operations.

Classes:

• BufferProviderBase - Base implementation for non-GTK contexts.
• DeleteManager - Client entry point for file deletion — delegates to File.delete RPC.
• DummyFileBuffer - In-memory buffer implementation for non-GTK contexts (tools, CLI).
• File - Represents a file in the project.
• FileAlias - Represents a symlink/alias to a file or folder.
• FileBase - Abstract base class providing common properties and methods for files and folders.
• FileChange - Represents a single edit operation with range and replacement.
• FileHistory - V2 approve/revert RPC handle ( file_history.id + path).
• FileWithHistory - Pending-approval list row (FileWithHistory wire). Popover display fields copied from FileBase — not a tree node.
• Folder - Represents a directory/folder in the project.
• FolderFiles - Manages immediate children of one Folder (flat list for tree UI).
• GitProviderBase - Base class for git operations with default no-op implementations.
• ProjectFile - Display wrapper for one File row in ProjectFiles.
• ProjectFiles - V2 client flat file list for one project (GLib.ListModel).
• ProjectList - V2 client project list — GLib.ListModel over known project rows.
• ProjectManager - V2 client ProjectManager — RPC to ollmfilesd, local UI state only.
• ReviewFiles - Manages files in a project that need approval (flat list for approvals UI).
• Tree - Tree-sitter AST path lookup (V2 thin client).
• TreeBase - Base class for tree-sitter AST parsing (V2 thin client).

Enums:

• FileUpdateStatus - Result of checking if a file has been updated on disk.
• OperationType - Operation type for file changes.
• Diff

Classes:

• Differ - Simple line-based diff implementation using Myers algorithm.
• Patch - Represents a patch operation with line numbers.
• PatchApplier - Applies patches to text.

Enums:

• PatchOperation - Patch operation types.
• SQT

Classes:

• VectorMetadata - Represents vector metadata stored in SQL database.
• OLLMfilesd

Classes:

• DaemonParams - Daemon.* request params.
• FileParams - File.* request params.
• FolderParams - Folder.* request params (project-scoped).
• ProjectParams - ProjectManager.* request params.
• VectorParams - vector.* request params.
• OLLMhf - Hugging Face Hub — search, model detail, and GGUF download.

Classes:

• Download - Download a Model's .gguf siblings into the local models tree.
• Model - Hub model metadata from search or detail responses.
• ModelArray - Wrapper for Hub search results.
• ModelCardData - Hub detail cardData.
• ModelConfig - Hub detail config (Hub API returns a short subset, not full config.json).
• ModelFile - One file entry from Hub model siblings[] (typically a .gguf).
• ModelGguf - Hub detail gguf metadata when present.
• ModelTokenizerConfig - Hub detail config.tokenizer_config when present.
• ModelTransformersInfo - Hub detail transformersInfo.
• ModelTreeArray - Decode-only wrapper for Hub repo tree listings.
• ModelTreeEntry - One file row from Hub GET /api/models/MODEL_ID/tree/REVISION.
• ModelTreeLfs - Hub tree row lfs metadata when present.
• ModelWidgetData - Hub detail widgetData[] entry.

Methods:

• public void rpc_register ()
  Register libochf wire types with OLLMrpc.Bin.
• Param

Classes:

• Search - Query bag for Hub model search.
• OLLMmcp

Classes:

• CallToolContentItem - One content item in MCP tools/call result (type "text" with "text" field).
• CallToolParams - Params for tools/call: name + arguments. Serialize with Json.gobject_serialize.
• CallToolResult - MCP tools/call result: "result" object with "content" array.
• Capabilities - MCP capabilities; empty object for now.
• ClientInfo - Client identity for MCP initialize (name + version). Defaults: ollmchat 1.0.
• Config - Configuration for a single MCP server (one service).
• Factory - Tool factory for one MCP tools/list entry (name, description, inputSchema).
• InitializeParams - MCP initialize request params (client → server). Property names match MCP spec (camelCase). All values have defaults; use as-is.
• InitializedNotification - Initialized notification (no id). Serialize with Json.gobject_serialize.
• JsonRpcRequest - JSON-RPC 2.0 request envelope. Set id, method, params; serialize with Json.gobject_serialize.
• Loader - Loads MCP servers: connect, tools/list, register Tool instances.
• McpJsonRpcError - JSON-RPC error object (response error member).
• Registry - Registry for MCP tools.
• Request - Executes one MCP tools/call with arguments from the agent tool call.
• Tool - One MCP tool exposed to the agent as OLLMchat.Tool.BaseTool.
• ToolsListResult - MCP tools/list result: "result" object with "tools" array of Factory.
• Client

Classes:

• Base - Abstract MCP client: one connection to one MCP server.
• Http - MCP client over HTTP: connects to an already-running MCP server at a URL. JSON-RPC via HTTP POST; no process lifecycle.
• Stdio - MCP client over stdio: starts the server as a subprocess and talks JSON-RPC over stdin/stdout (newline-delimited). Uses bubblewrap when available; otherwise requires allow_unsandboxed in mcp.json (Flatpak, Windows).
• OLLMrpc - Binary RPC client and wire types shared by apps and ollmfilesd.

Classes:

• CallParam - Base class for typed Request.param bags.
• Client - Bin RPC client for ollmfilesd, compositor sockets, and HTTPS JSON APIs.
• ClientBoot - Ensure ollmfilesd is running when passed to Client.connect.
• Daemon - Wire type for Daemon.hello (result is a one- element Daemon array). Client deserializes into this class. Server type is ollmfilesd/Daemon.vala (unchanged).
• Error - Wire error object (code, message ).
• Gi - Register GObject types from a typelib and apply RPC calls to them.
• Notification - Bin RPC notification (no matching Response id).
• Request - Outbound RPC envelope (one root object per call).
• Response - Inbound RPC envelope — matching Request.id, plus result or error.

Error domains:

• RpcErrorCode - JSON-RPC 2.0 standard and application error codes (throw/catch).
• Bin - Binary wire serialization for RPC payloads.

Interfaces:

• Serializable - GObject that encodes and decodes on a Stream.

Classes:

• Json - JSON ↔ bin bridge for tests, HTTP tooling, and debugging.
• Stream - Per-connection bin codec — write and parse Serializable objects.
• StreamValue - Encode or decode one GLib.Value on a Stream.

Enums:

• Mode - Json encode/decode and Stream GObject decode options.

Error domains:

• SerializableError - Serializable property encode/decode failures (throw/catch).
• StreamError - Stream wire / registration failures (throw/catch).

Methods:

• public void register (string alias, Type gtype) throws Error
  Map a wire alias string to a local GObject type (process-wide).

Fields:

• public HashMap<string,Type> alias_to_gtype
  Process-wide wire alias → GType for bin encode/decode.
• Live - Opt-in live GObject handles for OLLMrpc.

Classes:

• Buffer - One fd passed over SCM_RIGHTS on a Unix stream socket.
• BufferListen - Server-side **.fd** listen and pairing for one main RPC socket path.
• BufferStream - Per-connection SCM_RIGHTS fd channel — separate from the main bin RPC socket. All fd send/recv/watch logic lives here; OLLMrpc.Transport.Connection and OLLMrpc.Client only hold a reference and delegate.
• Remote - Process-wide handler for live-handle refcount RPCs.
• RemoteParams - Params for Remote ref / unref.
• Subscribe - Process-wide handler for live- handle signal subscribe.
• SubscribeParams - Params for Subscribe signal / unsubscribe.
• Subscription - Per-subscription holder for by-name GObject connect.
• Transport - Server listen and connection layer for OLLMrpc.

Classes:

• Connection - One RPC client channel — bin read/write loop (Unix socket).
• Listen - Server RPC entry — SocketListen; ollmfilesd adds Stdio transport.
• SocketListen - Unix socket Listen — one Connection per accepted client.
• TcpListen - TCP loopback Listen for platforms without Unix sockets.
• OLLMtools

Classes:

• FileVerification - Applies overlay scan results via OLLMfiles V2 RPC after OLLMbwrap.Bubble execution.
• Registry - Registry for all tools in liboctools.
• ToolBuilder - Builder class for creating wrapped tools from .tool definition files.
• Child

Classes:

• Agent - Agent instance for agent tool execution.
• Config - Tool-specific configuration for agent tools with model usage.
• Factory - Factory class that creates agent instances for agent tools.
• Parser - Parser class for parsing agent file frontmatter.
• Request - Request handler for agent tool execution.
• Tool - Main tool class that executes agent requests.
• CodebaseSearch

Classes:

• CodebaseSearchTool - Tool for semantic codebase search using vector embeddings.
• CodebaseSearchToolConfig - Tool-specific configuration for codebase search with multiple model usages.
• RequestCodebaseSearch - Request handler for codebase search operations.
• EditMode

Classes:

• Request - Request handler for editing files by activating "edit mode" for a file.
• Stream - Handles streaming content parsing for EditMode.
• Tool - Tool for editing files by activating "edit mode" for a file.
• Write - Pi-facing write tool — same Request/exec as Tool.
• GoogleSearch

Classes:

• Config - Tool-specific configuration for Google search tool.
• Request - Request handler for performing Google web searches.
• Result - Search results container from Google Custom Search API.
• ResultItem - Result item from Google Custom Search API.
• Tool - Tool for performing web searches using Google Custom Search API.
• HuggingFace

Classes:

• Request - Request container providing full API integration, VRAM profiling, and MTP guides.
• Tool - Tool for interacting with the Hugging Face Hub.
• ReadFile

Classes:

• Read - Pi-facing read tool — same Request/exec as Tool.
• Request - Request handler for reading file contents with optional line range support.
• Summarize - Tree-sitter based file structure summarizer.
• Tool - Tool for reading file contents with optional line range support.
• RunCommand

Classes:

• Bash - Pi-facing bash tool — same Request/exec as Tool.
• Request - Request handler for executing terminal commands in the project root directory.
• Tool - Tool for executing terminal commands in the project root directory.
• SessionFetch

Classes:

• Request - Request handler for session_fetch tool calls.
• Tool - Tool for recalling stored session messages by Chatter reference tag.
• WebFetch

Classes:

• Request - Request handler for fetching web content with automatic format detection and conversion.
• Tool - Tool for fetching web content with automatic format detection and conversion.
• WriteFile

Classes:

• Request
• Tool - One-shot file write tool. Same semantics as EditMode (permissions, backups) but content and mode are in the call; no streaming.
• OLLMwebkit - WebKit browser tool for OLLMchat — accessibility-driven browsing.

Classes:

• A11y - Accessibility dump / fill / press for Browser.
• A11yNode - One registered a11y node with window coordinates for layout emit.
• A11yParse - One AT-SPI / Win32Atspi tree walk that builds a11y Content / References markdown.
• Browser - One WebView browser session (Snappr Browser host port).
• BrowserStack - WebView host — primary browser in a Gtk.Stack (Snappr BrowserStack).
• Cloudflare - Target-site Cloudflare challenge detection for a Browser.
• Request - Deserialized browser tool call parameters and execution.
• Tool - OLLMchat tool wire name browser — drives BrowserStack.primary.
• OllamaWeb

Classes:

• Model - Ollama library model record (search row or per-slug JSON on disk).
• ModelVariant - One pullable tag/variant for a catalog model (list + size dropdown).
• Search

Classes:

• Cache - In-memory search result slug lists keyed by query, category, and sort set (24 h TTL).
• Client - HTTP client for ollama.com HTML pages.
• Parser - Parses Ollama.com search and tags HTML into OllamaWeb.Model records.
• Service - High-level search and model detail fetch against ollama.com.
• Session - Cached search + per-slug model directory coordinator (debounce/cancel owned by the app).

Enums:

• Category
• Sort

Error domains:

• Error
• SQ - Simple SQL builder for GObject values.

Classes:

• Database - Manages SQLite database connections with in- memory storage and file backup.
• Query - A generic SQL query builder for GObject-based types.
• Schema - Represents the schema information for a database table column.

Classes:

• TestAppBase - Base class for OLLMchat test applications.