@aparte/plugin-titler

Auto-title conversations in aparté with an aparte-titler model: 3 to 6 words picked out of the first message, in the browser, no API call. The model weighs 40 to 133 KB and titles in a few milliseconds.

npm install @aparte/plugin-titler @aparte/titler-latin

import type { AparteConversationManager } from '@aparte/core';
import { loadTitler } from '@aparte/titler-latin';   // 17 European languages, 133 KB
import { setupTitler } from '@aparte/plugin-titler';

declare const manager: AparteConversationManager;    // yours — the one the chat persists to
setupTitler(manager, { titler: loadTitler });

loadTitler is called once, the first time a conversation needs a title — the model is not on the page's critical path. A Titler instance or a promise of one (loadTitler()) is accepted in the same place, and so is any object with title(message, budget?) of your own (TitlerLike). budget caps the words (a short message can give fewer); without it the model keeps, among its six best-scored words, those it is at least half sure of, never fewer than three — and every word of a message of four words or fewer.

setupTitler returns a teardown that gives the manager back the provider it had. For a manager built with the titleProvider option, createTitleProvider(options) is the provider alone:

import { AparteConversationManager, type AparteStorageAdapter } from '@aparte/core';
import { loadTitler } from '@aparte/titler-latin';
import { createTitleProvider } from '@aparte/plugin-titler';

declare const adapter: AparteStorageAdapter;
const manager = new AparteConversationManager(adapter, {
    titleProvider: createTitleProvider({ titler: loadTitler, budget: 4 }),
});

An empty answer or a failed load leaves the default title (the message as typed): a titler that fails never loses the message from the sidebar.

Pick the model for your languages — @aparte/titler-latin (17 languages, 133 KB), @aparte/titler-latin-mini (the same 17, 96 KB), @aparte/titler-efigsp (en, fr, es, de, pt, it, 77 KB), or @aparte/titler with a single-language file (41 KB) from the model repository.

ESM-only. Part of the aparté monorepo. Try the model at apartejs.dev/models/titler/#demo.