Class TitleManager

Manages custom conversation titles from the extension host.

Titles are persisted in a JSON file in the workbench directory. The renderer-side title proxy reads this file and merges with localStorage.

Implements

Constructors

Accessors

Methods

  • Get all custom titles.

    Returns Readonly<Record<string, string>>

    A copy of the titles map (cascadeId -> title)

  • Get the custom title for a conversation.

    Parameters

    • cascadeId: string

      The conversation's cascade ID

    Returns undefined | string

    The custom title, or undefined if no custom title is set

  • Initialize with the workbench directory path.

    Parameters

    • workbenchDir: string

      Path to workbench directory where data file is stored

    • namespace: string = 'default'

      Extension namespace for file isolation

    Returns void

  • Remove a custom title, reverting to the auto-generated summary.

    Parameters

    • cascadeId: string

      The conversation's cascade ID

    Returns void

  • Set a custom title for a conversation.

    The title will be displayed in the Agent View title bar and conversation list instead of the auto-generated summary.

    Parameters

    • cascadeId: string

      The conversation's cascade ID (UUID)

    • title: string

      The custom title to display

    Returns void

    // Rename the active conversation
    const id = sdk.titles.getActiveCascadeId();
    sdk.titles.rename(id, 'Project Alpha Discussion');