Session Auto-Title

Sessions get a human-readable title automatically after the first exchange

An unnamed session earns a human-readable title on its own after the first user↔assistant exchange, so session list reads like a menu instead of a wall of opaque ids.

Quick Start

1. Just start a run — no naming needed

   praisonai run "Help me debug this Python import error"

2. After the first assistant reply, the title appears automatically

   praisonai session list
   # ID         Name                        Status   Events  Updated
   # 4f9a8c72   Debug Python Import Error   active   2       10:15

3. Set your own name upfront to opt out

   praisonai session start my-feature
   # An explicit title is never overwritten by auto-title

How It Works

Right after the run records usage, a post-run hook checks for the first exchange and generates a title only when one isn’t already set.

sequenceDiagram
    participant User
    participant Run as praisonai run/chat/code
    participant Hook as maybe_auto_title_session
    participant Store as Session Store
    participant Title as generate_title_async

    User->>Run: prompt
    Run-->>User: assistant reply
    Run->>Hook: accumulate_session_usage() then hook
    Hook->>Store: get_chat_history()
    alt first user↔assistant pair present AND no existing title
        Hook->>Title: (user_msg, assistant_msg, primary_model)
        Title-->>Hook: "Debug Python Import Error"
        Hook->>Store: rename_session(id, title)
    else no-op — skipped silently
        Hook-->>Run: return None
    end

The hook fires on the CLI post-run boundary of praisonai run, praisonai chat, and praisonai code — right after accumulate_session_usage(). It reuses the SDK’s generate_title_async and writes to the same metadata["title"] field that session rename writes and session list reads.

User Interaction Flow

No user action is needed — the title appears on its own after the first assistant reply.

Before (first exchange only — title job hasn’t fired yet):

ID         Name              Status   Events  Updated
4f9a8c72   4f9a8c72          active   1       10:14

After (post-first-turn hook has run):

ID         Name                          Status   Events  Updated
4f9a8c72   Debug Python Import Error     active   2       10:15

The id never changes — session resume 4f9a8c72-... still works. The title is display-only metadata.

Choose Your Path

Pick how a session gets its name.

Configuration Options

The auto-title path has no user-facing knobs — these signals govern it.

Model resolution

generate_title_async resolves the auxiliary model in this order: an explicit llm_model argument → defaults.small_model (config) → the session’s primary model → a cheap built-in default (gpt-4o-mini). The default resolves at call time, so env overrides set after import still take effect.

from praisonaiagents.session import generate_title_async

title = await generate_title_async(
    "Help me debug this Python import error",
    "Let's check your PYTHONPATH and module layout...",
    primary_model="gpt-4o",
)
# -> "Debug Python Import Error"

Best Practices

Related