Skip to content

Add traces service contract #73

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
haasonsaas merged 2 commits into from
Apr 15, 2026
Merged

Add traces service contract #73

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b634ac1
Add traces service contract
haasonsaas Apr 15, 2026
b738498
Increase proto buf generate timeout in CI
haasonsaas Apr 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .github/workflows/ci.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ jobs:
with:
go-version-file: go.mod
# go-version: "1.22"
- run: buf generate
- run: buf generate --timeout 10m
- name: Check generated code is up to date
run: |
if [ -n "$(git status --porcelain gen/)" ]; then
Expand Down Expand Up @@ -80,7 +80,7 @@ jobs:
node-version: 20
cache: npm
- run: npm ci
- run: buf generate
- run: buf generate --timeout 10m
- name: Check generated code is up to date
run: |
if [ -n "$(git status --porcelain gen/)" ]; then
Expand All @@ -102,7 +102,7 @@ jobs:
with:
python-version: "3.12"
- run: python -m pip install --upgrade build pip
- run: buf generate
- run: buf generate --timeout 10m
- name: Check generated code is up to date
run: |
if [ -n "$(git status --porcelain gen/)" ]; then
Expand Down
15 changes: 15 additions & 0 deletions descriptions.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -258,6 +258,21 @@ MeterService_QueryUsage: >-
MeterService_GetUsageSummary: >-
Get aggregated usage summary grouped by model, provider, team, agent,
surface, or metadata key. Returns totals for tokens and cost.

# --- traces/v1 ---
SpanIngestService_IngestSpans: >-
Record one or more execution spans for an agent trace. Stores span identity,
parent/child relationships, token usage, governance outcome, latency, and
cost metadata, then returns updated trace summaries for the affected traces.
SpanIngestService_GetTrace: >-
Retrieve a trace by ID. Returns the trace summary plus the flat span list for
inspection or downstream tree reconstruction.
SpanIngestService_ListTraces: >-
List traces by workspace, agent, surface, or time range. Returns paginated
trace summaries with total count metadata.
SpanIngestService_GetSpanTree: >-
Retrieve a trace as a parent/child span tree. Used for execution debugging,
attribution, and governance review.
Copy link
Copy Markdown

@cursor cursor bot Apr 15, 2026

Choose a reason for hiding this comment

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

Traces descriptions split MeterService section in descriptions file

Low Severity

The new traces/v1 descriptions block is inserted between MeterService_GetUsageSummary and MeterService_GetMeterSummary, splitting the MeterService entries into two non-contiguous groups. All other service sections in this file keep their RPCs grouped together under a comment header. This breaks the organizational convention and makes it easy for future editors to miss that some MeterService entries live below the traces block.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit b634ac1. Configure here.

MeterService_GetMeterSummary: >-
Get summary for a specific meter ID, grouped by the requested dimension.
MeterService_IngestWideEvent: >-
Expand Down
Loading
Loading