Skip to content

docs(proposals): streaming token accumulation (#119)#239

Open
henschwartz wants to merge 1 commit into
praxis-proxy:mainfrom
henschwartz:proposal/00119-streaming-token-accumulation
Open

docs(proposals): streaming token accumulation (#119)#239
henschwartz wants to merge 1 commit into
praxis-proxy:mainfrom
henschwartz:proposal/00119-streaming-token-accumulation

Conversation

@henschwartz

Copy link
Copy Markdown

Summary

  • Adds proposal docs/proposals/00119_streaming-token-accumulation.md for issue #119
  • Contains What? and Why? only (no How? per first-PR proposal rules)

Test plan

  • CI proposal-check passes (issue link, authors, stakeholders present; no How? section)
  • Maintainer review of goals and motivation

@henschwartz henschwartz requested review from a team and leseb July 2, 2026 09:19
@henschwartz henschwartz requested a review from shaneutt as a code owner July 2, 2026 09:19
@praxis-bot-app

praxis-bot-app Bot commented Jul 2, 2026

Copy link
Copy Markdown

Unsigned commits: 13fc85b. Please sign your commits.

@praxis-bot-app

praxis-bot-app Bot commented Jul 2, 2026

Copy link
Copy Markdown

Missing Signed-off-by: 13fc85b. All commits require sign-off (via git commit --signoff).

@henschwartz henschwartz force-pushed the proposal/00119-streaming-token-accumulation branch from 13fc85b to c319bbf Compare July 2, 2026 09:30

@praxis-bot praxis-bot left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

praxis-bot review: docs(proposals): streaming token accumulation (#119)

Documentation-only PR adding a What?/Why? proposal for streaming token accumulation.

Overall Assessment

Well-written proposal with clear goals, non-goals, and motivation. Two issues found, both related to completeness.

Findings

# Severity File Description
1 Medium 00119_streaming-token-accumulation.md:145 Missing [#119] link definition — renders as broken reference
2 Medium 00119_streaming-token-accumulation.md:148-153 Relationship to existing proposal #211 deferred as open question rather than stated in the body

Comment thread docs/proposals/00119_streaming-token-accumulation.md Outdated
Comment thread docs/proposals/00119_streaming-token-accumulation.md Outdated
@henschwartz henschwartz force-pushed the proposal/00119-streaming-token-accumulation branch from c319bbf to faa3253 Compare July 5, 2026 07:23
@shaneutt shaneutt added this to the v0.1.0 milestone Jul 8, 2026
@shaneutt shaneutt moved this from Next to Review in AI Gateway - Model Serving Jul 8, 2026
Comment on lines +138 to +143
### Stream completion signal

Should completion rely on the `[DONE]` sentinel, on
`end_of_stream` from the proxy, or both? Google omits `[DONE]`,
so stream close may need to be authoritative while still handling
providers that terminate with `[DONE]`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

this looks more like a decision on how to do it per provider

Some providers send running totals in intermediate chunks; others
send only the final total once. Should the accumulator always treat
the latest parsed value as authoritative (last-wins), or sum
deltas? The answer is likely per-provider and must be specified in

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

yes it looks like a how to me :)

…-proxy#119 for incremental SSE token counting so maintainers can review goals and motivation before design.

Signed-off-by: Hen Schwartz <hschwart@redhat.com>
@henschwartz henschwartz force-pushed the proposal/00119-streaming-token-accumulation branch from ed55b84 to 211b2e9 Compare July 9, 2026 08:01
@henschwartz

henschwartz commented Jul 9, 2026

Copy link
Copy Markdown
Author

Hi @didierofrivia and @leseb I edited the PR to remove all the questions which will enter later on the "how" section

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

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

5 participants