Skip to content

feat: add conv/flow hover descriptions, goto_step navigation, and autocomplete#16

Merged
dhandal09 merged 2 commits intopolyai:mainfrom
sophyphile:sami/conv-and-flow-helpers
Mar 23, 2026
Merged

feat: add conv/flow hover descriptions, goto_step navigation, and autocomplete#16
dhandal09 merged 2 commits intopolyai:mainfrom
sophyphile:sami/conv-and-flow-helpers

Conversation

@sophyphile
Copy link
Copy Markdown
Contributor

Description

Adds three new Python language features for working with conv.* and flow.* attributes in ADK project code:

  1. Hover descriptions — Hovering over conv.say, conv.state, flow.goto_step, etc. shows descriptions, signatures, parameter info, and return types sourced from the runtime
  2. Go to Step — Cmd+Click on the step name in flow.goto_step("Step Name") navigates directly to the corresponding step YAML file
  3. Autocomplete — Typing conv. or flow. shows all available attributes and methods with descriptions and parameter snippet placeholders

Also includes:

  • src/generated/runtimeDescriptions.ts with 65 Conversation + 4 Flow member descriptions
  • Updated README with new Python language features

Type of Change

  • feat - New feature (minor release)
  • fix - Bug fix (patch release)
  • docs - Documentation only
  • style - Code style changes (formatting, etc.)
  • refactor - Code refactoring
  • perf - Performance improvements (patch release)
  • test - Adding or updating tests
  • chore - Maintenance tasks
  • ci - CI/CD changes
  • build - Build system changes

Checklist

  • My PR title follows the Conventional Commits format
  • I have tested my changes locally in the Extension Development Host
  • My code follows the existing code style of this project
  • I have updated the documentation if necessary

Related Issues

…ocomplete

- Hover over conv.* and flow.* attributes to see descriptions,
  signatures, parameter info, and return types from the runtime
- Cmd+Click on flow.goto_step("Step Name") navigates to the
  corresponding step YAML file (full-string clickable link)
- Type conv. or flow. to get autocomplete suggestions for all
  available attributes and methods with parameter snippets
- Add src/generated/runtimeDescriptions.ts with 65 Conversation
  and 4 Flow member descriptions
- Update README with new Python language features
@sophyphile sophyphile requested a review from a team March 20, 2026 17:55
@github-actions
Copy link
Copy Markdown

✅ Valid PR Title

Type Release Breaking
feat minor false

This PR will trigger a minor release when merged to main.

The version will be automatically determined by semantic-release based on the commit messages.

@dhandal09 dhandal09 merged commit afb2693 into polyai:main Mar 23, 2026
2 checks passed
poly-adk-bot bot pushed a commit that referenced this pull request Mar 23, 2026
## [1.2.0](v1.1.0...v1.2.0) (2026-03-23)

### Features

* add conv/flow hover descriptions, goto_step navigation, and autocomplete ([#16](#16)) ([afb2693](afb2693))
@poly-adk-bot
Copy link
Copy Markdown

poly-adk-bot bot commented Mar 23, 2026

🎉 This PR is included in version 1.2.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants