feat(hook): session.before.idle

[spoons-and-mirrors]

What does this PR do?

This PR add a session.before.idle hook.

This allows (for example) plugins to do async work for a subagent session, and resume that subagent session on work result.

How did you verify your code works?

Using it in Pocket Universe plugin, works as expected.

[github-actions]

Thanks for your contribution!

This PR doesn't have a linked issue. All PRs must reference an existing issue.

Please:

1. Open an issue describing the bug/feature (if one doesn't exist)
2. Add Fixes #<number> or Closes #<number> to this PR description

See CONTRIBUTING.md for details.

[github-actions]

The following comment was made by an LLM, it may be inaccurate:

No duplicate PRs found

[kziemski]

will this be merged in?

[jensenojs]

I feel like this (the plugin behind the scenes) seems to better match what I imagine agent teams should look like, but for the maintainers of opencode, all of this might not be so obvious?

• https://github.com/spoons-and-mirrors/pocket-universe
• [FEATURE]: Add Agent Teams Equivalent or Better #12661

[spoons-and-mirrors]

yeah i've been super busy with work lately, and have not had time to lobby for this hook enough hehe

I hope to have some time soon to push for this to get merged as well as keep working on the pocket universe plugin to be able to showcase the power of it

[rektide]

always love me a good @spoons-and-mirrors PR. i have some questions (as just a random joe walking by):

• i'm not sure what the advantage of this is over the existing session.hooks?
• at a minimum, it feels like this should be session.idle.before. that would follow other conventions. there are no other foo.before.bar style examples.
• session.idle is now deprecated, replaced by a session.status that does it all. we should probably follow that lead if we need to.