Find existing Model record or auto-create one linked to provider credential.

Add a ContextItem to the builder. Args: item: ContextItem to add

Check if a provider has sufficient env vars configured for migration.

Get status and error_message of the associated command

Get all sources with optional notebook filtering.

Get the processing status of the associated command

Delete a record by record id

Update an existing record by table and id

Submit a podcast generation job for background processing

Add note to context. Args: note_id: ID of the note inclusion_level: "full content" or "not in"

Create a Credential from a database row, decrypting api_key.

Get plain text splitter using CHUNK_SIZE and CHUNK_OVERLAP constants.

Truncate text to max_length to avoid leaking verbose internal details.

Submit insight creation as an async command (fire-and-forget). Submits a create_insight command that handles database operations wit

Clear the singleton instance (useful for testing)

Discover available models for a specific provider. Args: provider: Provider name (openai, anthropic, etc.) Returns: Lis

Generate and store embeddings for a source document. Creates multiple chunk embeddings stored in the source_embedding table. Uses conten

Encrypt a string value using Fernet symmetric encryption. Args: value: The plain text string to encrypt. Returns: Base6

* Fetch configuration from the API or use defaults.

Get the Credential object linked to this model, if any.

Get default modalities for a provider.

Get the default model for a specific type. Args: model_type: The type of model to retrieve (e.g., 'chat', 'embedding', e

Get Fernet instance with the configured encryption key. Returns: Fernet instance. Raises: ValueError: If encryption key

Get the version of an installed package. Args: package_name (str): Name of the installed package Returns: str: Version

Get detailed processing information for the associated command

Fetch and parse the version from pyproject.toml in a public GitHub repository. Args: repo_url (str): URL of the GitHub repository

Check if migration is needed.

Remove non-ASCII characters from text.

Remove non-printable characters from text.

Create or update a record in the specified table

Save credential, handling api_key re-hydration after DB round-trip.

Sync models for a provider: discover and optionally register in database. Args: provider: Provider name auto_register: If Tr

Add notebook content based on context configuration. Args: notebook_id: ID of the notebook

Apply secondary chunking to ensure no chunk exceeds CHUNK_SIZE tokens. Used when primary splitters (HTML/Markdown) produce oversized chunks.

Build text that exceeds a token threshold.

Build text that stays within a token budget.

Calculate confidence score for HTML content.

Calculate confidence score for Markdown content.

Derive a valid Fernet key from an arbitrary string via SHA-256. Any string is accepted as input. The key is derived by hashing it with S

Find an existing Model record matching provider + name + type.