Standardize Session Name Attribute by wpfleger96 · Pull Request #5085 · aaif-goose/goose

wpfleger96 · 2025-10-08T22:28:34Z

Summary

This PR standardizes session attribute naming by migrating from the description field to name throughout the codebase, with full backwards compatibility support. The change introduces a user_set_name boolean flag to differentiate between user-provided names and auto-generated names, preventing AI from overwriting custom session names.

Key Changes

Backend: Updated SessionManager and Session struct to use name field with user_set_name flag. Database schema migration to v3 renames the sessions.description column to sessions.name and adds user_set_name column. Serde alias ensures backwards compatibility for JSON deserialization. The maybe_update_name method now respects user-set names.

Frontend: Added sessionCompat.ts utility module providing getSessionName() helper that gracefully handles both old (description) and new (name) formats. Updated components (SessionHistoryView, SessionItem, SessionListView, SessionsView) to use the compatibility layer. OpenAPI schema and TypeScript types updated to reflect new field names.

Database Migration: Includes goose-db-helper.sh script for safe schema migrations with backup capabilities. Migration tests ensure data integrity during the transition. Database changes are non-destructive with automatic backups before migration.

Type of Change

Testing

I added 2 unit tests for this work, and I manually tested with my local Goose

Related Issues

Related to #5044

Screenshots/Demos (for UX changes)

Before:

After:

DOsinga · 2025-10-11T17:48:29Z

let me know when you need a review

* main: (55 commits) [docs] Add Blog Post: "Designing AI for Users, Not Just LLMs" (aaif-goose#5190) docs: update cognee, jetbrains, mbot extensions config (aaif-goose#5172) Minimally disable subagents when not in autonomous model (aaif-goose#5149) Fix provider sort (aaif-goose#5188) blog: Getting Started with Goose on Windows (aaif-goose#5156) feat: add CI/CD Pipeline recipe (aaif-goose#5183) feat: add Daily Standup Report Generator recipe (aaif-goose#5123) (aaif-goose#5131) Sort providers in alphabetical vs random (aaif-goose#5090) Declarative providers (aaif-goose#5084) adding youtube link to firecrawl mcp tutorial, merge after 9am Eastern Oct 15 (aaif-goose#5173) Ollama integration: modified default model + added models (aaif-goose#5153) Fix codex subagent configuration in documentation (aaif-goose#5180) fix: include apple silicon build of the desktop app in build artifacts (aaif-goose#5174) fixing video embed (aaif-goose#5171) chore: clean up random unused files (aaif-goose#5166) fix: adjust download_cli.sh to tolerate no OS variable (aaif-goose#5169) mcp tutorial page for firecrawl (aaif-goose#5152) Remove orphaned tool calls before compaction (aaif-goose#5059) feat: add copy as markdown button to documentation pages (aaif-goose#5158) chore: include vendored node executable (aaif-goose#5160) ...

* main: Compaction overhaul (aaif-goose#5186) fix: aaif-goose#3960 better approach to input schema for dynamic task params (aaif-goose#5189) used recipe id or deeplink to start agent (aaif-goose#5154)

wpfleger96 · 2025-10-15T23:55:01Z

@DOsinga this should be ready for review now!

let me know what you think about the goose-db-helper.sh script, it was pretty helpful for me while testing but it ended up getting pretty massive... maybe that should be refactored into a proper Python package

wpfleger96 · 2025-10-16T17:32:40Z

Test failure is unrelated and addressed in #5207

* main: Blog: Best Practices for Prompt Engineering with goose (aaif-goose#5204) force WAL sync after session create (aaif-goose#5202) Feat: goose Apify MCP integration docs (aaif-goose#5047) feat: enhance goose to search sessions for easy recall (aaif-goose#5177) Skip hidden & real format (aaif-goose#5194) docs: Hacktoberfest blog submission - Best Practices for Using Goose in Enterprise Environments by Anudhyan Datta. (aaif-goose#5184) docs: prompt injection detection (aaif-goose#5193) Fix mcp large response race condition (aaif-goose#5065)

* main: Revert "feat: enhance goose to search sessions for easy recall (aaif-goose#5177)" (aaif-goose#5209)

…atibility

wpfleger96 · 2025-10-16T20:43:42Z

@DOsinga I think I addressed all your feedback, would you mind giving this another glance over before I merge?

DOsinga

I think we should revert to making name required when starting a session

Resolved conflicts in auto-generated API files by regenerating them using the updated @hey-api/openapi-ts v0.85.2 package. The regenerated files properly incorporate both the session naming standardization changes from this branch and the latest updates from main.

wpfleger96 · 2025-10-17T20:32:43Z

@DOsinga ok this should be ready for another glance over, per your feedback I reverted back to requiring a name when starting a session

DOsinga · 2025-10-17T20:37:25Z

yeah merge when ready!

* main: Standardize Session Name Attribute (#5085) Docs: Include step-by-step model configuration instructions for first… (#5239) Delete message visibility filter (#5216) delete flaky pricing integration tests (#5207) chore: upgrade most npm packages to latest (#5185) Release/1.11.0 (#5224) Rewrite extension management tools (#5057) fix: re-sync package-lock.json (#5235) docs: Hacktoberfest MCP youtube short entry to community-content.json (#5150) feat: add schedule button to recipe entries (#5217) Autocompact threshold UI cleanup (#5232) fix: correct schema for openai tools (#5229)

michaelneale · 2025-10-18T06:48:05Z

this isn't backwards compatible if you roll back a version of goose (which may happen):

17:46:43.054 › from renderer: [UNHANDLED REJECTION] Error: Failed to create session: error returned from database: (code: 1) table sessions has no column named description

or in cli:

thread 'main' panicked at /Users/micn/Development/goose/crates/goose-cli/src/session/builder.rs:319:10:
called Result::unwrap() on an Err value: error returned from database: (code: 1) table sessions has no column named description

So this is only one way compatible. I think need to roll it back unless there is a strategy for this.

This reverts commit b8c3508.

DOsinga · 2025-10-18T14:56:23Z

it's a good point. we should roll this back and then do it by adding the column name and keep description around for a while

wpfleger96 · 2025-10-18T14:58:54Z

👍 great point, let's roll back and I'll try again next week and be careful to make this more backwards compatible

DOsinga · 2025-10-18T15:07:26Z

thank you @wpfleger96 !

* origin/main: (66 commits) Revert "Rewrite extension management tools" (#5243) Standardize Session Name Attribute (#5085) Docs: Include step-by-step model configuration instructions for first… (#5239) Delete message visibility filter (#5216) delete flaky pricing integration tests (#5207) chore: upgrade most npm packages to latest (#5185) Release/1.11.0 (#5224) Rewrite extension management tools (#5057) fix: re-sync package-lock.json (#5235) docs: Hacktoberfest MCP youtube short entry to community-content.json (#5150) feat: add schedule button to recipe entries (#5217) Autocompact threshold UI cleanup (#5232) fix: correct schema for openai tools (#5229) Break compaction back into check_ and do_ compaction (#5212) fix: revert built app name to uppercase Goose (#5206) feat: add Code Documentation Generator recipe (#5121) (#5125) Revert "feat: enhance goose to search sessions for easy recall (#5177)" (#5209) Blog: Best Practices for Prompt Engineering with goose (#5204) force WAL sync after session create (#5202) Feat: goose Apify MCP integration docs (#5047) ...

* main: (32 commits) turn off WAL (#5203) Skip subagents for gemini (#5257) Revert "Standardize Session Name Attribute" (#5250) improve provider request logging a bit (#5236) Fix OpenAI empty choices panic (#5248) Revert "Rewrite extension management tools" (#5243) Standardize Session Name Attribute (#5085) Docs: Include step-by-step model configuration instructions for first… (#5239) Delete message visibility filter (#5216) delete flaky pricing integration tests (#5207) chore: upgrade most npm packages to latest (#5185) Release/1.11.0 (#5224) Rewrite extension management tools (#5057) fix: re-sync package-lock.json (#5235) docs: Hacktoberfest MCP youtube short entry to community-content.json (#5150) feat: add schedule button to recipe entries (#5217) Autocompact threshold UI cleanup (#5232) fix: correct schema for openai tools (#5229) Break compaction back into check_ and do_ compaction (#5212) fix: revert built app name to uppercase Goose (#5206) ...

* 'main' of github.com:block/goose: docs: provide more clarity in tagging step of releases (#5269) docs: add GOOSE_DEBUG environment variable (#5265) Lifei/UI parameter input (#5222) turn off WAL (#5203) Skip subagents for gemini (#5257) Revert "Standardize Session Name Attribute" (#5250) improve provider request logging a bit (#5236) Fix OpenAI empty choices panic (#5248) Revert "Rewrite extension management tools" (#5243) Standardize Session Name Attribute (#5085) Docs: Include step-by-step model configuration instructions for first… (#5239) Delete message visibility filter (#5216) delete flaky pricing integration tests (#5207) chore: upgrade most npm packages to latest (#5185) Release/1.11.0 (#5224)

* main: (40 commits) Fix extension manager resource deadlock (#5066) add new prompt for memory extension (#4945) feat: Stable system prompt and tool ordering for more cache hits (#5192) Remove gtag analytics error (#5268) Feat/smart task organizer recipe (#5032) docs: `goose recipe open` command (#5264) docs: provide more clarity in tagging step of releases (#5269) docs: add GOOSE_DEBUG environment variable (#5265) Lifei/UI parameter input (#5222) turn off WAL (#5203) Skip subagents for gemini (#5257) Revert "Standardize Session Name Attribute" (#5250) improve provider request logging a bit (#5236) Fix OpenAI empty choices panic (#5248) Revert "Rewrite extension management tools" (#5243) Standardize Session Name Attribute (#5085) Docs: Include step-by-step model configuration instructions for first… (#5239) Delete message visibility filter (#5216) delete flaky pricing integration tests (#5207) chore: upgrade most npm packages to latest (#5185) ...

wpfleger96 added 2 commits October 8, 2025 17:17

Standardize on session name instead of description

7c5db7d

Make everything backwards compatible

d0be934

wpfleger96 changed the title ~~Standardize Session Name Attribute~~ Standardize Session Name Attribute (WIP) Oct 8, 2025

wpfleger96 added 5 commits October 15, 2025 16:49

Add migration tests

0d7c19b

Add DB migration helper script

c37fc07

Merge branch 'main' into wpfleger/standardize-session-attributes

28f91db

* main: Compaction overhaul (aaif-goose#5186) fix: aaif-goose#3960 better approach to input schema for dynamic task params (aaif-goose#5189) used recipe id or deeplink to start agent (aaif-goose#5154)

Bug fixes when merging another DB migration from main branch

0de3460

wpfleger96 marked this pull request as ready for review October 15, 2025 23:51

botched merge conflict resolution

b53f983

linter findings

2b8bc8f

wpfleger96 changed the title ~~Standardize Session Name Attribute (WIP)~~ Standardize Session Name Attribute Oct 16, 2025

wpfleger96 added 3 commits October 16, 2025 13:41

missed this one when merging latest changes from main

ae04e4e

Merge branch 'main' into wpfleger/standardize-session-attributes

3e6cd28

* main: Revert "feat: enhance goose to search sessions for easy recall (aaif-goose#5177)" (aaif-goose#5209)

DOsinga approved these changes Oct 16, 2025

View reviewed changes

wpfleger96 added 5 commits October 16, 2025 14:31

comment cleanup

4b7aa71

We should still accept matching session ID -> name for backwards comp…

967d6c6

…atibility

Finish standardizing session naming: API, UI, and CLI search consistency

484baee

Get rid of unnecessary public user_set_name function

7bdafc8

clarify serde alias

f5fa139

DOsinga approved these changes Oct 17, 2025

View reviewed changes

Comment thread ui/desktop/src/components/sessions/SessionHistoryView.tsx Outdated

Comment thread crates/goose/src/session/session_manager.rs

Comment thread crates/goose/src/session/session_manager.rs Outdated

Comment thread crates/goose/src/session/session_manager.rs Outdated

wpfleger96 added 2 commits October 17, 2025 15:32

Name should be required when starting a session

44c9a15

Unrelated redundant condition check that Claude Code found

43d9416

wpfleger96 force-pushed the wpfleger/standardize-session-attributes branch from 2f28716 to 43d9416 Compare October 17, 2025 20:14

silly LLM change

2389e98

DOsinga merged commit b8c3508 into aaif-goose:main Oct 17, 2025
13 of 15 checks passed

michaelneale added a commit that referenced this pull request Oct 18, 2025

Revert "Standardize Session Name Attribute (#5085)"

641fb8d

This reverts commit b8c3508.

michaelneale mentioned this pull request Oct 18, 2025

Revert "Standardize Session Name Attribute" #5250

Merged

wpfleger96 mentioned this pull request Oct 20, 2025

(re)Standardize Session Name Attribute #5279

Merged

9 tasks

Conversation

wpfleger96 commented Oct 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Key Changes

Type of Change

Testing

Related Issues

Screenshots/Demos (for UX changes)

Uh oh!

DOsinga commented Oct 11, 2025

Uh oh!

wpfleger96 commented Oct 15, 2025

Uh oh!

wpfleger96 commented Oct 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

wpfleger96 commented Oct 16, 2025

Uh oh!

DOsinga left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

wpfleger96 commented Oct 17, 2025

Uh oh!

DOsinga commented Oct 17, 2025

Uh oh!

Uh oh!

michaelneale commented Oct 18, 2025

Uh oh!

DOsinga commented Oct 18, 2025

Uh oh!

wpfleger96 commented Oct 18, 2025

Uh oh!

DOsinga commented Oct 18, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

wpfleger96 commented Oct 8, 2025 •

edited

Loading

wpfleger96 commented Oct 16, 2025 •

edited

Loading