Skip to content

docs(protocol): describe parentID on session create - #63653

Merged
thdxr merged 1 commit into
devfrom
subagent-parent-docs
Nov 13, 2026
Merged

thdxr merged 1 commit into
devfrom
subagent-parent-docs

Conversation

@thdxr

@thdxr thdxr commented Nov 13, 2026

Copy link
Copy Markdown
Member

Issue for this PR

requested by dax.

Type of change

  • documentation

What does this PR do?

explains how to start a child session and when it reports back, right on the parentID field in the api spec.

How did you verify your code works?

regenerated the spec and clients, checked the generated spec, and ran the protocol typecheck.

Screenshots / recordings

n/a

Checklist

  • tested locally
  • only related changes

— from 𝕺𝖕𝖊𝖓𝕮𝖔𝖉𝖊

@thdxr
thdxr merged commit 7e441d3 into dev Nov 13, 2026
12 checks passed
@thdxr
thdxr deleted the subagent-parent-docs branch November 13, 2026 02:30

@opencodejr opencodejr Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Docs-only change that looks good. I checked the new parentID description against the code:

  • When parentID is set, the server handler drops location, so the child runs at the parent's location.
  • The child's report reaches the parent's inbox as a <subagent> message.
  • The parent is only woken when it has no staged revert.

The regenerated openapi.json matches the schema annotation.

Public API: unchanged. Only a field description is added to the session.create request schema in the OpenAPI spec; no fields, types or behaviour change.

No concerns.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant