feat: add API endpoint to list/retrieve tool execution logs #1040

tgmendes · 2025-12-10T13:53:26Z

Creates the API to be able to query for tool logs.

Examples

curl -X GET 'https://localhost:8080/rpc/logs.listToolExecutionLogs?per_page=2&sort=DESC' 
-H 'Gram-Key: <redacted>' 
-H 'Gram-Project: default' 
--insecure -s | jq

Fetching next page:

curl -X GET 'https://localhost:8080/rpc/logs.listToolExecutionLogs?per_page=2&sort=DESC&cursor=019b0900-0004-7000-8000-000000000004' 
-H 'Gram-Key: redacted' 
-H 'Gram-Project: default' 
--insecure -s | jq

linear · 2025-12-10T13:53:29Z

AGE-972 feat: add clickhouse tool logs to dashboard

changeset-bot · 2025-12-10T13:53:30Z

🦋 Changeset detected

Latest commit: 349336f

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
server	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2025-12-10T13:53:31Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
gram	Ready	Preview	Comment	Dec 11, 2025 2:38pm
gram-docs-redirect	Ready	Preview	Comment	Dec 11, 2025 2:38pm
gram-landing-redirect	Ready	Preview	Comment	Dec 11, 2025 2:38pm

…-tool-logs

tgmendes · 2025-12-10T14:56:10Z

server/internal/telemetry/impl.go

 	}
 }
+
+func (s *Service) ListToolExecutionLogs(ctx context.Context, payload *gen.ListToolExecutionLogsPayload) (res *gen.ListToolExecutionLogsResult, err error) {


Note: I had to rename these methods to ListToolExecutionLogs rather than just ListToolLogs because of conflicts with names of other endpoints for the service.

For consistency I'll update the name used in the repo queries as well in a separate PR (which are now called ListToolLogs).

tgmendes · 2025-12-10T14:57:04Z

server/internal/telemetry/list_logs_test.go

The tests here were redundant now that we have the broader service tests

disintegrator · 2025-12-11T12:29:09Z

server/design/toolmetrics/design.go

+
+		Meta("openapi:operationId", "listToolExecutionLogs")
+		Meta("openapi:extension:x-speakeasy-name-override", "listToolExecutionLogs")
+		Meta("openapi:extension:x-speakeasy-react-hook", `{"name": "ListToolExecutionLogs"}`)


Suggested change

Meta("openapi:extension:x-speakeasy-react-hook", `{"name": "ListToolExecutionLogs"}`)

Meta("openapi:extension:x-speakeasy-react-hook", `{"name": "ToolExecutionLogs"}`)

will map to useToolExecutionLogs instead of useListToolExecutionLogs

disintegrator · 2025-12-11T12:30:15Z

server/design/toolmetrics/design.go

+		Enum("ASC", "DESC")
+		Default("DESC")


are these case insensitive? (prefer they're lowercase regardless)

server/internal/telemetry/impl.go

…-tool-logs

- explicit error handling of incorrect params - lowercase DESC and ASC in pagination - change react name to follow convention

…-tool-logs

tgmendes added 9 commits December 9, 2025 17:00

chore: add queries to list tool logs stored in clickhouse

15e0bd4

chore: add readme and claude instructions to generate clickhouse queries

2172d33

chore: fix linter issues

00b4728

chore: create repo folder and move repo queries there

15edc6e

chore: move 'log' impl logic to telemetry folder

fa63e8d

chore: fix telemetry code with new folder structure

8fa48b0

fix: fix dependencies on log repo

8acdb01

chore: add service logic to handle retrieving tool execution logs

f2e9b09

feat: add API design for new endpoint to retrieve tool execution logs

39d0f8d

vercel bot deployed to Preview – gram December 10, 2025 13:54 View deployment

Base automatically changed from tiago/age-972-refactor-telemetry-structure to main December 10, 2025 14:24

Merge remote-tracking branch 'origin/main' into tiago/age-972-api-for…

c627d6b

…-tool-logs

vercel bot deployed to Preview – gram-landing-redirect December 10, 2025 14:30 View deployment

vercel bot deployed to Preview – gram-docs-redirect December 10, 2025 14:30 View deployment

vercel bot deployed to Preview – gram December 10, 2025 14:31 View deployment

tgmendes changed the title ~~Tiago/age 972 api for tool logs~~ feat: add API endpoint to list/retrieve tool execution logs Dec 10, 2025

tgmendes added 2 commits December 10, 2025 14:34

chore: remove redundant test now that we have service test

9db2e29

chore: update goa design and gen

59681ac

vercel bot deployed to Preview – gram-landing-redirect December 10, 2025 14:35 View deployment

vercel bot deployed to Preview – gram-docs-redirect December 10, 2025 14:35 View deployment

vercel bot deployed to Preview – gram December 10, 2025 14:36 View deployment

chore: delete redundant queries file

38d4bdf

vercel bot deployed to Preview – gram-docs-redirect December 10, 2025 14:58 View deployment

vercel bot deployed to Preview – gram-landing-redirect December 10, 2025 14:58 View deployment

vercel bot deployed to Preview – gram December 10, 2025 14:59 View deployment

tgmendes added 2 commits December 10, 2025 15:49

chore: fix and simplify query pagination

bf3062a

chore: update tests and sort

b00a8bf

vercel bot deployed to Preview – gram-docs-redirect December 10, 2025 17:47 View deployment

vercel bot deployed to Preview – gram-landing-redirect December 10, 2025 17:47 View deployment

vercel bot deployed to Preview – gram December 10, 2025 17:48 View deployment

tgmendes commented Dec 11, 2025

View reviewed changes

disintegrator approved these changes Dec 11, 2025

View reviewed changes

tgmendes added 2 commits December 11, 2025 13:09

Merge remote-tracking branch 'origin/main' into tiago/age-972-api-for…

bb33238

…-tool-logs

chore: improve API experience

4b4e54d

- explicit error handling of incorrect params - lowercase DESC and ASC in pagination - change react name to follow convention

vercel bot had a problem deploying to Preview – gram-docs-redirect December 11, 2025 14:23 Failure

vercel bot deployed to Preview – gram-landing-redirect December 11, 2025 14:23 View deployment

vercel bot deployed to Preview – gram December 11, 2025 14:25 View deployment

chore: regenerate server asserts

9260d34

vercel bot had a problem deploying to Preview – gram-docs-redirect December 11, 2025 14:25 Failure

vercel bot deployed to Preview – gram-landing-redirect December 11, 2025 14:25 View deployment

vercel bot deployed to Preview – gram December 11, 2025 14:26 View deployment

chore: generate sdk assets

bc89720

vercel bot had a problem deploying to Preview – gram-docs-redirect December 11, 2025 14:31 Failure

vercel bot deployed to Preview – gram-landing-redirect December 11, 2025 14:31 View deployment

vercel bot deployed to Preview – gram December 11, 2025 14:32 View deployment

Merge remote-tracking branch 'origin/main' into tiago/age-972-api-for…

d967d99

…-tool-logs

vercel bot deployed to Preview – gram-docs-redirect December 11, 2025 14:34 View deployment

vercel bot deployed to Preview – gram-landing-redirect December 11, 2025 14:34 View deployment

vercel bot deployed to Preview – gram December 11, 2025 14:35 View deployment

chore: update speakeasy version and regenerate sdk

349336f

vercel bot deployed to Preview – gram-docs-redirect December 11, 2025 14:37 View deployment

vercel bot deployed to Preview – gram-landing-redirect December 11, 2025 14:37 View deployment

vercel bot deployed to Preview – gram December 11, 2025 14:38 View deployment

tgmendes merged commit e0b26ea into main Dec 11, 2025
24 of 29 checks passed

tgmendes deleted the tiago/age-972-api-for-tool-logs branch December 11, 2025 14:48

github-actions bot locked and limited conversation to collaborators Dec 11, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: add API endpoint to list/retrieve tool execution logs #1040

feat: add API endpoint to list/retrieve tool execution logs #1040

Uh oh!

tgmendes commented Dec 10, 2025 •

edited

Loading

Uh oh!

linear bot commented Dec 10, 2025

Uh oh!

changeset-bot bot commented Dec 10, 2025 •

edited

Loading

Uh oh!

vercel bot commented Dec 10, 2025 •

edited

Loading

Uh oh!

tgmendes Dec 10, 2025

Uh oh!

tgmendes Dec 10, 2025

Uh oh!

disintegrator Dec 11, 2025

Uh oh!

disintegrator Dec 11, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

	Meta("openapi:extension:x-speakeasy-react-hook", `{"name": "ListToolExecutionLogs"}`)
	Meta("openapi:extension:x-speakeasy-react-hook", `{"name": "ToolExecutionLogs"}`)

feat: add API endpoint to list/retrieve tool execution logs #1040

feat: add API endpoint to list/retrieve tool execution logs #1040

Uh oh!

Conversation

tgmendes commented Dec 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Examples

Uh oh!

linear bot commented Dec 10, 2025

Uh oh!

changeset-bot bot commented Dec 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot commented Dec 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tgmendes Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

tgmendes Dec 10, 2025

Choose a reason for hiding this comment

Uh oh!

disintegrator Dec 11, 2025

Choose a reason for hiding this comment

Uh oh!

disintegrator Dec 11, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

tgmendes commented Dec 10, 2025 •

edited

Loading

changeset-bot bot commented Dec 10, 2025 •

edited

Loading

vercel bot commented Dec 10, 2025 •

edited

Loading