feat(flint): add Flint integration with agent task tools, block, and docs by waleedlatif1 · Pull Request #5641 · simstudioai/sim

waleedlatif1 · 2026-07-13T19:07:50Z

Summary

Add Flint integration (Agent Tasks API): flint_create_task (prompt tasks), flint_generate_pages (template-based page generation, 1-10 pages), flint_get_task (status + created/modified/deleted pages)
Bearer API-key auth against https://app.tryflint.com/api/v1; items JSON parsed/validated at execution time so block references survive serialization
New Flint block with operation dropdown, conditional fields, advanced-mode publish/callback options, wand config for the pages JSON, and 8 BlockMeta templates + 3 skills
FlintIcon (monochrome, currentColor for bare/theme-safe rendering), registered in tool/block registries and icon mappings, generated docs page
No file upload/download endpoints exist in the Flint API, so no file-handling plumbing is needed

Manual Description

Flint is an AI website builder — this integration lets workflows drive its background agent over the Agent Tasks API (two endpoints: POST /agent/tasks, GET /agent/tasks/{taskId}).

To exercise it manually:

Drop the Flint block on the canvas and paste a Flint API key (ak_..., from Flint team settings).
Create Task: enter a Site ID and a prompt like "Add a new About page with a team section" — returns taskId with status running.
Generate Pages: enter the Site ID, a template page slug (e.g. /case-studies/template), and a JSON array of 1-10 {targetPageSlug, context} items (the wand can generate it) — returns a taskId.
Get Task: poll with the returned taskId until status is completed (exposes pagesCreated/pagesModified/pagesDeleted with preview/edit/published URLs) or failed (exposes errorMessage).
Advanced mode adds a Publish on Completion switch and a webhook Callback URL for both create operations.

Type of Change

New feature

Testing

Typecheck, biome, check:bare-icons, and block/tool registry test suites (168 tests) pass; tools validated against https://www.flint.com/docs/api

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)

…docs

vercel · 2026-07-13T19:07:56Z

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Jul 13, 2026 7:31pm

waleedlatif1 · 2026-07-13T19:07:59Z

@greptile

waleedlatif1 · 2026-07-13T19:08:00Z

@cursor review

cursor · 2026-07-13T19:08:01Z

PR Summary

Medium Risk
Workflows can trigger live site changes and optional auto-publish via a third-party API using stored API keys; scope is limited to a new integration following existing tool/block patterns with input validation.

Overview
Adds a Flint integration so workflows can drive Flint’s Agent Tasks API (Bearer API key against https://app.tryflint.com/api/v1).

Three new tools cover the task lifecycle: create task from a natural-language prompt, generate pages (1–10 items from a template slug, with JSON parse/validation at execution time), and get task (status plus created/modified/deleted page URLs). A new Flint canvas block wires those operations with conditional fields, advanced publish / callback options, and coercePublish so an explicit false is not dropped. Catalog surfaces get FlintIcon, block/tool registry entries, integrations.json, docs (flint.mdx), and BlockMeta templates/skills.

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

greptile-apps · 2026-07-13T19:10:06Z

Greptile Summary

This PR adds a Flint integration for running and polling background agent tasks. The main changes are:

New Flint block with create, generate pages, and get task operations.
New Flint tools for Agent Tasks API requests and response shaping.
Flint icon, registry, integration metadata, and docs entries.
Runtime validation for generated page items.

Confidence Score: 5/5

This looks safe to merge.

No blocking issues found in the changed code.

Important Files Changed

Filename	Overview
apps/sim/blocks/blocks/flint.ts	Adds the Flint block and preserves explicit publish-off values through parameter mapping.
apps/sim/tools/flint/create_task.ts	Adds task creation and fails responses that do not return a usable task ID.
apps/sim/tools/flint/generate_pages.ts	Adds page generation with item validation and task ID response checks.
apps/sim/tools/flint/get_task.ts	Adds task polling with normalized page outputs and missing task ID handling.
apps/sim/tools/flint/utils.ts	Adds shared Flint API URL, bearer headers, and user-only API key configuration.
apps/sim/tools/registry.ts	Registers the Flint tools under their matching tool IDs.

_{Reviews (6): Last reviewed commit: "fix(flint): drop json-object generation ..." | Re-trigger Greptile}

greptile-apps · 2026-07-13T19:10:38Z

Greptile Summary

This PR adds Flint as a new Sim integration. The main changes are:

New Flint block with create, generate pages, and get task operations.
New Flint tool configs for the Agent Tasks API.
Flint icon, registry entries, integration metadata, and docs page.
Runtime JSON parsing for generated page items.

Confidence Score: 4/5

The Flint publish mapping needs a fix before merging.

Registry, icon, API-key visibility, and JSON item handling follow the established integration patterns.
The block can omit an explicit publish opt-out before the request reaches Flint.
That can make live publishing depend on Flint's default instead of the user's switch value.

apps/sim/blocks/blocks/flint.ts

Security Review

The publish option can be omitted when a user explicitly turns publishing off, which may allow live Flint site changes if the API default publishes.

Important Files Changed

Filename	Overview
apps/sim/blocks/blocks/flint.ts	Adds the Flint block, UI fields, tool mapping, metadata templates, and skills; the publish mapping drops explicit false values.
apps/sim/tools/flint/create_task.ts	Adds the create task ToolConfig with bearer auth, POST body construction, and task-created output mapping.
apps/sim/tools/flint/generate_pages.ts	Adds the generate pages ToolConfig with item parsing, validation, and request body construction.
apps/sim/tools/flint/get_task.ts	Adds the task polling ToolConfig and normalizes returned page arrays into nullable page objects.
apps/sim/tools/flint/utils.ts	Adds shared Flint API URL, bearer headers, and user-only API key parameter metadata.
apps/sim/tools/registry.ts	Registers the three Flint tools under matching snake_case IDs.
apps/sim/blocks/registry-maps.ts	Registers the Flint block and metadata in the block registries.
apps/sim/components/icons.tsx	Adds the Sim Flint icon with currentColor fills.
apps/docs/components/icons.tsx	Adds the docs Flint icon with currentColor fills.
apps/docs/content/docs/en/integrations/flint.mdx	Adds the Flint integration documentation page.

_{Reviews (2): Last reviewed commit: "feat(flint): add Flint integration with ..." | Re-trigger Greptile}

…gn default params branch with tool fallback

waleedlatif1 · 2026-07-13T19:14:34Z

@greptile

waleedlatif1 · 2026-07-13T19:14:35Z

@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 ee0eead. Configure here.}

waleedlatif1 · 2026-07-13T19:20:51Z

@greptile

waleedlatif1 · 2026-07-13T19:20:52Z

@cursor review

…ges array

waleedlatif1 · 2026-07-13T19:31:56Z

@greptile

waleedlatif1 · 2026-07-13T19:31:57Z

@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 4458216. Configure here.}

waleedlatif1 · 2026-07-13T20:19:31Z

@greptile

waleedlatif1 · 2026-07-13T20:19:32Z

@cursor review

cursor

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

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

cursor · 2026-07-13T20:22:44Z

+  if (value === true || value === 'true') return true
+  if (value === false || value === 'false') return false
+  return undefined
+}


Off publish switch still omits field

Medium Severity

coercePublish returns undefined when Publish on Completion was never toggled, so publish is omitted from the Flint request. The switch still renders off via Boolean(null/undefined), so the UI looks unpublished while Flint can apply its server default. Basic-mode runs never show the switch, so they always hit that omit path.

Additional Locations (1)

apps/sim/blocks/blocks/flint.ts#L147-L159

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

feat(flint): add Flint integration with agent task tools, block, and …

e52fe77

…docs

greptile-apps Bot reviewed Jul 13, 2026

View reviewed changes

Comment thread apps/sim/blocks/blocks/flint.ts Outdated

Comment thread apps/sim/blocks/blocks/flint.ts

Comment thread apps/sim/tools/flint/create_task.ts

Comment thread apps/sim/tools/flint/generate_pages.ts

cursor Bot reviewed Jul 13, 2026

View reviewed changes

Comment thread apps/sim/blocks/blocks/flint.ts

greptile-apps Bot reviewed Jul 13, 2026

View reviewed changes

Comment thread apps/sim/blocks/blocks/flint.ts Outdated

vercel Bot deployed to Preview July 13, 2026 19:12 View deployment

fix(flint): forward explicit publish=false, guard missing taskId, ali…

ee0eead

…gn default params branch with tool fallback

vercel Bot temporarily deployed to Preview July 13, 2026 19:13 Inactive

docs(flint): add manual intro section to integration docs page

d9921b7

greptile-apps Bot reviewed Jul 13, 2026

View reviewed changes

Comment thread apps/sim/tools/flint/get_task.ts

cursor Bot reviewed Jul 13, 2026

View reviewed changes

vercel Bot deployed to Preview July 13, 2026 19:20 View deployment

fix(flint): fail get_task on OK responses without a task ID

511c1c0

vercel Bot temporarily deployed to Preview July 13, 2026 19:20 Inactive

cursor Bot reviewed Jul 13, 2026

View reviewed changes

Comment thread apps/sim/blocks/blocks/flint.ts

fix(flint): drop json-object generation type so the wand emits the pa…

4458216

…ges array

vercel Bot temporarily deployed to Preview July 13, 2026 19:31 Inactive

cursor Bot reviewed Jul 13, 2026

View reviewed changes

waleedlatif1 merged commit e94e514 into staging Jul 13, 2026
18 checks passed

waleedlatif1 deleted the worktree-flint-integration branch July 13, 2026 20:06

waleedlatif1 mentioned this pull request Jul 13, 2026

improvement(flint): set json language on the pages code input #5643

Merged

6 tasks

cursor Bot reviewed Jul 13, 2026

View reviewed changes

waleedlatif1 mentioned this pull request Jul 13, 2026

v0.7.32: concurrency control, seo/geo, new lib #5646

Merged

Uh oh!

Conversation

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

Uh oh!

Summary

Manual Description

Type of Change

Testing

Checklist

Uh oh!

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

Uh oh!

Uh oh!

waleedlatif1 commented Jul 13, 2026

Uh oh!

waleedlatif1 commented Jul 13, 2026

Uh oh!

cursor Bot commented Jul 13, 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 13, 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

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

greptile-apps Bot commented Jul 13, 2026

Greptile Summary

Confidence Score: 4/5

Security Review

Important Files Changed

Uh oh!

Uh oh!

waleedlatif1 commented Jul 13, 2026

Uh oh!

waleedlatif1 commented Jul 13, 2026

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

waleedlatif1 commented Jul 13, 2026

Uh oh!

waleedlatif1 commented Jul 13, 2026

Uh oh!

Uh oh!

waleedlatif1 commented Jul 13, 2026

Uh oh!

waleedlatif1 commented Jul 13, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

waleedlatif1 commented Jul 13, 2026

Uh oh!

waleedlatif1 commented Jul 13, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot Jul 13, 2026

Choose a reason for hiding this comment

Off publish switch still omits field

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

waleedlatif1 commented Jul 13, 2026 •

edited

Loading

vercel Bot commented Jul 13, 2026 •

edited

Loading

cursor Bot commented Jul 13, 2026 •

edited

Loading

greptile-apps Bot commented Jul 13, 2026 •

edited

Loading