feat(tinybird): validate integration against API, add job-status polling by waleedlatif1 · Pull Request #5474 · simstudioai/sim

waleedlatif1 · 2026-07-07T15:23:56Z

Summary

Validated all 6 existing Tinybird tools against Tinybird's live REST API docs (Events, Query, Pipes, Data Sources) — every endpoint, param, and response shape checked out, no bugs found
Added tinybird_get_job tool + block operation to poll async job status (Append and Delete Data Source Rows return a job_id/job_url with no way to check on it — this closes that gap)
Scoped block outputs with condition per operation so each operation only surfaces the fields it actually returns

Type of Change

New feature / improvement

Testing

Tested manually. bun run type-check, bun run lint:check, bun run check:api-validation, and blocks/blocks.test.ts + tools/index.test.ts all pass.

Checklist

Code follows project style guidelines
Self-reviewed my changes
Tests added/updated and passing
No new warnings introduced
I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

…ing, scope block outputs - Validated all 6 existing tools against Tinybird's live REST API docs - Added tinybird_get_job tool to poll async import/delete jobs - Scoped block outputs with per-operation condition

vercel · 2026-07-07T15:24:03Z

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Jul 7, 2026 3:37pm

cursor · 2026-07-07T15:24:08Z

PR Summary

Low Risk
Additive integration feature and UI metadata changes; no changes to auth, billing, or core execution paths.

Overview
Adds Get Job Status so workflows can poll Tinybird async jobs (append/delete) via a new tinybird_get_job tool (GET /v0/jobs/{job_id}), wired through the Tinybird block with a required Job ID field and dedicated outputs (kind, timestamps, is_cancellable, error, etc.).

The Tinybird block outputs are now gated with condition per operation so only fields relevant to the selected operation appear (query vs events vs datasource vs job polling). Docs/skills are updated with a poll-job-status skill and a note to poll after append/delete.

Minor copy fixes align API token scope hints with Tinybird naming (DATASOURCES:*, PIPES:READ).

^{Reviewed by Cursor Bugbot for commit c7c5463. Configure here.}

greptile-apps · 2026-07-07T15:28:43Z

Greptile Summary

This PR adds a tinybird_get_job tool to poll the status of asynchronous Tinybird jobs (append/delete), and scopes existing block output fields with per-operation condition guards to reduce noise in the UI.

New get_job tool (tools/tinybird/get_job.ts, types.ts, index.ts, registry.ts): implements GET /v0/jobs/{job_id}, extracts and returns key job fields alongside the full raw response as job.
Block output conditions (blocks/tinybird.ts): all outputs now carry condition predicates so only the fields relevant to the selected operation are surfaced; new Get Job Status operation and matching inputs/outputs are wired in.
Description fixes (events.ts, query.ts, query_pipe.ts, append_datasource.ts): corrects API scope names (PIPE:READ → PIPES:READ, DATASOURCE:APPEND → DATASOURCES:APPEND).

Confidence Score: 5/5

Safe to merge — the new tool follows existing patterns faithfully, all fields are properly nullable, and the description fixes are low-risk corrections to user-facing text.

The new tinybird_get_job tool mirrors the structure of the existing append and delete tools: same URL-encoding, same auth header pattern, same errorExtractor, same nullable output mapping. The block wiring adds a new operation and scopes outputs with conditions that only hide/show fields per operation — no existing behavior is altered. The scope-name description fixes in the other tools are purely cosmetic corrections.

No files require special attention.

Important Files Changed

Filename	Overview
apps/sim/tools/tinybird/get_job.ts	New tool implementing GET /v0/jobs/{job_id}; follows established tool patterns with correct auth header, URL encoding, and transformResponse; job field is intentionally the full raw response for kind-specific fields.
apps/sim/blocks/blocks/tinybird.ts	Adds Get Job Status operation with input/output wiring and conditions; scopes all existing outputs with per-operation conditions; clean integration with existing block config pattern.
apps/sim/tools/tinybird/types.ts	Adds TinybirdGetJobParams and TinybirdGetJobResponse interfaces; union type updated; all fields are correctly nullable to match API variability.
apps/sim/tools/tinybird/index.ts	Exports new getJobTool as tinybirdGetJobTool; consistent with existing export pattern.
apps/sim/tools/registry.ts	Registers tinybird_get_job tool in the tool registry; straightforward addition.
apps/sim/tools/tinybird/events.ts	Corrects token description scope name from DATASOURCE:APPEND to DATASOURCES:APPEND.
apps/sim/tools/tinybird/query.ts	Corrects token description scope name from PIPE:READ to PIPES:READ.
apps/sim/tools/tinybird/query_pipe.ts	Corrects token description scope name from PIPE:READ to PIPES:READ, matching query.ts fix.
apps/sim/tools/tinybird/append_datasource.ts	Corrects token description scope name from DATASOURCES:CREATE to DATASOURCES:APPEND or DATASOURCES:CREATE.

Sequence Diagram

%%{init: {'theme': 'neutral'}}%%
sequenceDiagram
    participant User
    participant SimBlock as Tinybird Block
    participant AppendTool as tinybird_append_datasource
    participant DeleteTool as tinybird_delete_datasource_rows
    participant GetJobTool as tinybird_get_job (new)
    participant TinybirdAPI as Tinybird REST API

    User->>SimBlock: Select Append Data Source
    SimBlock->>AppendTool: "POST /v0/datasources?mode=append"
    AppendTool->>TinybirdAPI: POST /v0/datasources
    TinybirdAPI-->>AppendTool: job_id, status waiting
    AppendTool-->>SimBlock: job_id, job_url, status
    SimBlock-->>User: job_id returned

    User->>SimBlock: Select Get Job Status
    SimBlock->>GetJobTool: job_id from previous step
    GetJobTool->>TinybirdAPI: "GET /v0/jobs/{job_id}"
    TinybirdAPI-->>GetJobTool: id, kind, status, created_at
    GetJobTool-->>SimBlock: id, job_id, kind, status, job_url, error, job
    SimBlock-->>User: Poll until status is done or error

    User->>SimBlock: Select Delete Data Source Rows
    SimBlock->>DeleteTool: datasource, delete_condition
    DeleteTool->>TinybirdAPI: "DELETE /v0/datasources/{name}/deletions"
    TinybirdAPI-->>DeleteTool: job_id, status waiting
    DeleteTool-->>SimBlock: job_id, delete_id, status
    SimBlock-->>User: job_id returned for polling

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
sequenceDiagram
    participant User
    participant SimBlock as Tinybird Block
    participant AppendTool as tinybird_append_datasource
    participant DeleteTool as tinybird_delete_datasource_rows
    participant GetJobTool as tinybird_get_job (new)
    participant TinybirdAPI as Tinybird REST API

    User->>SimBlock: Select Append Data Source
    SimBlock->>AppendTool: "POST /v0/datasources?mode=append"
    AppendTool->>TinybirdAPI: POST /v0/datasources
    TinybirdAPI-->>AppendTool: job_id, status waiting
    AppendTool-->>SimBlock: job_id, job_url, status
    SimBlock-->>User: job_id returned

    User->>SimBlock: Select Get Job Status
    SimBlock->>GetJobTool: job_id from previous step
    GetJobTool->>TinybirdAPI: "GET /v0/jobs/{job_id}"
    TinybirdAPI-->>GetJobTool: id, kind, status, created_at
    GetJobTool-->>SimBlock: id, job_id, kind, status, job_url, error, job
    SimBlock-->>User: Poll until status is done or error

    User->>SimBlock: Select Delete Data Source Rows
    SimBlock->>DeleteTool: datasource, delete_condition
    DeleteTool->>TinybirdAPI: "DELETE /v0/datasources/{name}/deletions"
    TinybirdAPI-->>DeleteTool: job_id, status waiting
    DeleteTool-->>SimBlock: job_id, delete_id, status
    SimBlock-->>User: job_id returned for polling

_{Reviews (2): Last reviewed commit: "fix(tinybird): align token-scope descrip..." | Re-trigger Greptile}

…scope names - events/query/query_pipe used singular DATASOURCE:/PIPE: scope names; Tinybird's Token API uses plural DATASOURCES:/PIPES: - append_datasource now notes DATASOURCES:APPEND also suffices, not just CREATE

waleedlatif1 · 2026-07-07T15:45:15Z

@greptile review

waleedlatif1 · 2026-07-07T15:45:16Z

@cursor review

cursor

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit c7c5463. Configure here.}

feat(tinybird): validate integration against API, add job-status poll…

8c29fd2

…ing, scope block outputs - Validated all 6 existing tools against Tinybird's live REST API docs - Added tinybird_get_job tool to poll async import/delete jobs - Scoped block outputs with per-operation condition

vercel Bot temporarily deployed to Preview July 7, 2026 15:37 Inactive

cursor Bot reviewed Jul 7, 2026

View reviewed changes

waleedlatif1 merged commit 6d97b26 into staging Jul 7, 2026
18 checks passed

waleedlatif1 deleted the tinybird-validate-integration branch July 7, 2026 15:54

waleedlatif1 mentioned this pull request Jul 7, 2026

v0.7.25: new tools, gmail send fixes, email lifecycle adjustments #5490

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(tinybird): validate integration against API, add job-status polling#5474

feat(tinybird): validate integration against API, add job-status polling#5474
waleedlatif1 merged 2 commits into
stagingfrom
tinybird-validate-integration

waleedlatif1 commented Jul 7, 2026

Uh oh!

vercel Bot commented Jul 7, 2026 •

edited

Loading

Uh oh!

cursor Bot commented Jul 7, 2026 •

edited

Loading

Uh oh!

greptile-apps Bot commented Jul 7, 2026 •

edited

Loading

Uh oh!

waleedlatif1 commented Jul 7, 2026

Uh oh!

waleedlatif1 commented Jul 7, 2026

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

waleedlatif1 commented Jul 7, 2026

Summary

Type of Change

Testing

Checklist

Uh oh!

vercel Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cursor Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

greptile-apps Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Greptile Summary

Confidence Score: 5/5

Important Files Changed

Sequence Diagram

Uh oh!

waleedlatif1 commented Jul 7, 2026

Uh oh!

waleedlatif1 commented Jul 7, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

vercel Bot commented Jul 7, 2026 •

edited

Loading

cursor Bot commented Jul 7, 2026 •

edited

Loading

greptile-apps Bot commented Jul 7, 2026 •

edited

Loading