feat: record created_at/completed_at on reasoning ChatMessageParts (#24789)

Records reasoning start and end times on persisted reasoning
`ChatMessagePart`s so reasoning duration can be computed for stored
chats. Backend-only: no SSE changes and no frontend rendering ship in
this PR.

The `created_at` field on `ChatMessagePart` is extended to also be
present on `reasoning` parts (it previously appeared only on `tool-call`
and `tool-result`), and a new `completed_at` field is added for
`reasoning` parts.

### How timestamps are recorded

- `StreamPartTypeReasoningStart`: stamp `startedAt = dbtime.Now()` on
the active reasoning state.
- `StreamPartTypeReasoningEnd`: stamp `completedAt = dbtime.Now()` and
append both into parallel `[]time.Time` slices on `stepResult`.
- Persistence reads the slices in occurrence order (reasoning has no
provider-side ID) and applies them to the matching `ChatMessagePart` via
`buildAssistantPartsForPersist`. The first reasoning block's stamps go
onto the first reasoning part, and so on.
- `flushActiveState` flushes partial reasoning interrupted before
`StreamPartTypeReasoningEnd` with `startedAt` from the active state and
`completedAt = dbtime.Now()` at the interruption.

### Why two fields, not one?

Tool calls and results are point events. The frontend computes their
duration by subtracting the call's `created_at` from the result's
`created_at`. Reasoning is one assistant part that brackets a span, so
we record both endpoints on the part itself.

### Why not stamp in `PartFromContent`?

Same rationale as #24101: `PartFromContent` is called during both SSE
publishing and persistence. Stamping there would yield incorrect
persistence-time timestamps for reasoning blocks that finished much
earlier in the step. Instead we capture in the chatloop and apply during
persistence.

<details><summary>Implementation plan</summary>

- `codersdk/chats.go`: extend `CreatedAt`'s `variants` to include
`reasoning?`; add `CompletedAt *time.Time` with `variants:"reasoning?"`.
- `coderd/x/chatd/chatloop/chatloop.go`: extend `reasoningState` with
`startedAt`; extend `stepResult` and `PersistedStep` with parallel
`[]time.Time` reasoning slices; stamp on
`ReasoningStart`/`ReasoningEnd`; thread the slices through all
`PersistStep` call sites including the interrupt-safe path; record
partial reasoning in `flushActiveState`.
- `coderd/x/chatd/attachments.go`: walk reasoning parts in occurrence
order and apply `step.ReasoningStartedAt[i]` to `part.CreatedAt` and
`step.ReasoningCompletedAt[i]` to `part.CompletedAt`.

### Tests

- `codersdk/chats_test.go` round-trips `created_at` + `completed_at` on
reasoning parts and verifies omission when absent and partial
interrupted parts.
- `coderd/x/chatd/chatprompt/chatprompt_test.go` asserts
`PartFromContent(ReasoningContent{})` does NOT stamp timestamps.
- `coderd/x/chatd/chatloop/chatloop_test.go`
`TestRun_ReasoningTimestamps` drives a stream with two reasoning blocks
and verifies parallel slices, monotonicity, ordering, non-zero values,
and content-block ordering.
`TestRun_InterruptedReasoningFlushesTimestamps` cancels mid-reasoning
and verifies `flushActiveState` records a non-zero pair.
- `coderd/x/chatd/attachments_test.go` covers
`buildAssistantPartsForPersist` for normal interleaved reasoning,
partial (zero `completed_at`), and missing slices.

</details>

> Generated by Coder Agents.

Co-authored-by: Coder Agent <agent@coder.com>
This commit is contained in:
Kyle Carberry
2026-05-18 12:30:30 -04:00
committed by GitHub
co-authored by Coder Agent
parent 46821525f7
commit 385146000b
12 changed files with 661 additions and 179 deletions
+167
View File
@@ -4415,3 +4415,170 @@ func TestExecuteSingleTool_MediaBase64Encoding(t *testing.T) {
require.Contains(t, textOutput.Text, "world")
})
}
// TestRun_ReasoningTimestamps verifies that StreamPartTypeReasoningStart
// and StreamPartTypeReasoningEnd produce parallel ReasoningStartedAt /
// ReasoningCompletedAt slices on PersistedStep, in the same occurrence
// order as the reasoning content blocks. The frontend computes
// reasoning duration as completed_at - started_at.
func TestRun_ReasoningTimestamps(t *testing.T) {
t.Parallel()
model := &chattest.FakeModel{
ProviderName: "fake",
StreamFn: func(_ context.Context, _ fantasy.Call) (fantasy.StreamResponse, error) {
return streamFromParts([]fantasy.StreamPart{
{Type: fantasy.StreamPartTypeReasoningStart, ID: "reason-1"},
{Type: fantasy.StreamPartTypeReasoningDelta, ID: "reason-1", Delta: "first thought"},
{Type: fantasy.StreamPartTypeReasoningEnd, ID: "reason-1"},
{Type: fantasy.StreamPartTypeReasoningStart, ID: "reason-2"},
{Type: fantasy.StreamPartTypeReasoningDelta, ID: "reason-2", Delta: "second thought"},
{Type: fantasy.StreamPartTypeReasoningEnd, ID: "reason-2"},
{Type: fantasy.StreamPartTypeTextStart, ID: "text-1"},
{Type: fantasy.StreamPartTypeTextDelta, ID: "text-1", Delta: "answer"},
{Type: fantasy.StreamPartTypeTextEnd, ID: "text-1"},
{Type: fantasy.StreamPartTypeFinish, FinishReason: fantasy.FinishReasonStop},
}), nil
},
}
var persistedSteps []PersistedStep
err := Run(context.Background(), RunOptions{
Model: model,
Messages: []fantasy.Message{
textMessage(fantasy.MessageRoleUser, "think"),
},
MaxSteps: 1,
PersistStep: func(_ context.Context, step PersistedStep) error {
persistedSteps = append(persistedSteps, step)
return nil
},
})
require.NoError(t, err)
require.Len(t, persistedSteps, 1)
step := persistedSteps[0]
// Both reasoning blocks must produce parallel timestamp entries.
require.Len(t, step.ReasoningStartedAt, 2,
"each StreamPartTypeReasoningEnd must record a started_at")
require.Len(t, step.ReasoningCompletedAt, 2,
"each StreamPartTypeReasoningEnd must record a completed_at")
// Timestamps must be monotonic per block (completed_at >= started_at),
// and both timestamps must be populated. Asserting only monotonicity
// is not enough: time.Time{} is year 0001, so completed_at.Before(zero)
// is trivially false and a regression that drops the started_at stamp
// would slip past the comparison.
for i := range step.ReasoningStartedAt {
require.False(t, step.ReasoningStartedAt[i].IsZero(),
"started_at[%d] must be non-zero", i)
require.False(t, step.ReasoningCompletedAt[i].IsZero(),
"completed_at[%d] must be non-zero", i)
require.False(t,
step.ReasoningCompletedAt[i].Before(step.ReasoningStartedAt[i]),
"completed_at[%d] must be >= started_at[%d]", i, i)
}
// Successive blocks must be ordered: reasoning-2 cannot start
// before reasoning-1 completes.
require.False(t,
step.ReasoningStartedAt[1].Before(step.ReasoningCompletedAt[0]),
"reasoning-2 started_at must be >= reasoning-1 completed_at")
// The reasoning content blocks must appear in the same order
// in step.Content so the persistence layer can correlate by
// occurrence order.
var reasoningOrder []string
for _, c := range step.Content {
if r, ok := fantasy.AsContentType[fantasy.ReasoningContent](c); ok {
reasoningOrder = append(reasoningOrder, r.Text)
}
}
require.Equal(t, []string{"first thought", "second thought"}, reasoningOrder)
}
func TestRun_InterruptedReasoningFlushesTimestamps(t *testing.T) {
t.Parallel()
started := make(chan struct{})
model := &chattest.FakeModel{
ProviderName: "fake",
StreamFn: func(ctx context.Context, _ fantasy.Call) (fantasy.StreamResponse, error) {
return iter.Seq[fantasy.StreamPart](func(yield func(fantasy.StreamPart) bool) {
parts := []fantasy.StreamPart{
{Type: fantasy.StreamPartTypeReasoningStart, ID: "reason-1"},
{Type: fantasy.StreamPartTypeReasoningDelta, ID: "reason-1", Delta: "interrupted thought"},
}
for _, part := range parts {
if !yield(part) {
return
}
}
select {
case <-started:
default:
close(started)
}
<-ctx.Done()
_ = yield(fantasy.StreamPart{
Type: fantasy.StreamPartTypeError,
Error: ctx.Err(),
})
}), nil
},
}
ctx, cancel := context.WithCancelCause(context.Background())
defer cancel(nil)
go func() {
<-started
cancel(ErrInterrupted)
}()
var persistedStep PersistedStep
err := Run(ctx, RunOptions{
Model: model,
Messages: []fantasy.Message{
textMessage(fantasy.MessageRoleUser, "think"),
},
MaxSteps: 1,
PersistStep: func(_ context.Context, step PersistedStep) error {
persistedStep = step
return nil
},
})
require.ErrorIs(t, err, ErrInterrupted)
// flushActiveState must have appended exactly one entry to each
// parallel slice, matching the single in-progress reasoning block.
require.Len(t, persistedStep.ReasoningStartedAt, 1,
"interrupted reasoning must flush its started_at")
require.Len(t, persistedStep.ReasoningCompletedAt, 1,
"interrupted reasoning must flush a completed_at stamp")
// Both timestamps must be populated and the completed stamp
// must be at or after the started stamp.
require.False(t, persistedStep.ReasoningStartedAt[0].IsZero(),
"flushed reasoning started_at must be non-zero")
require.False(t, persistedStep.ReasoningCompletedAt[0].IsZero(),
"flushed reasoning completed_at must be non-zero")
require.False(t,
persistedStep.ReasoningCompletedAt[0].Before(persistedStep.ReasoningStartedAt[0]),
"flushed completed_at must be >= started_at")
// The flushed reasoning content must appear in step.Content so
// the persistence layer's occurrence-order correlation lines up
// with the timestamp slices.
var reasoningBlocks []fantasy.ReasoningContent
for _, c := range persistedStep.Content {
if r, ok := fantasy.AsContentType[fantasy.ReasoningContent](c); ok {
reasoningBlocks = append(reasoningBlocks, r)
}
}
require.Len(t, reasoningBlocks, 1)
require.Equal(t, "interrupted thought", reasoningBlocks[0].Text)
}