René's URL Explorer Experiment


Title: feat(tinyfish): add TinyFish web agent, search, and fetch integration by waleedlatif1 · Pull Request #7177 · simstudioai/sim · GitHub

Open Graph Title: feat(tinyfish): add TinyFish web agent, search, and fetch integration by waleedlatif1 · Pull Request #7177 · simstudioai/sim

X Title: feat(tinyfish): add TinyFish web agent, search, and fetch integration by waleedlatif1 · Pull Request #7177 · simstudioai/sim

Description: Summary Adds the TinyFish integration: 8 tools, a block, the brand icon, and hosted-key support. Built against TinyFish's published OpenAPI specs (agent/search/fetch), not prose docs — every request field, response mapping, and enum is traceable to a spec path. Agent: tinyfish_run (sync), tinyfish_run_async, tinyfish_get_run, tinyfish_cancel_run, tinyfish_list_runs, tinyfish_list_vault_items. Search: tinyfish_search. Fetch: tinyfish_fetch. Hosted key via TINYFISH_API_KEY_COUNT / TINYFISH_API_KEY_1..N, plus a tinyfish BYOK provider. Hosted key and metering Agent bills on the num_of_steps the API reports × $0.016/step. getCost throws rather than estimating if that field is missing. Search and Fetch are free products, so they use per_request pricing at cost: 0. Fetch throttles on a urls dimension (40/min) because TinyFish's documented ceiling is 150 URLs/min, not requests/min. tinyfish_run_async, get_run, cancel_run, list_runs, and list_vault_items deliberately declare no hosting. An async run's charge accrues after the request returns, so it can never be metered at call time. The block uses the established duplicate-apiKey split so those operations always show the key field. Two gaps worth a reviewer's attention, both stated rather than papered over: A run that ends FAILED returns HTTP 200 with a step count, but the executor meters only successful executions — so TinyFish charges the hosted wallet for those steps and Sim bills nothing. Closing this needs a change to the executor's success gate, not to the pricing function. Documented in hosting.ts and pinned by a test. TinyFish's real Agent ceiling is 2 concurrent runs per account; the token bucket has no concurrency dimension, so requestsPerMinute: 5 is a proxy, not an equivalent. Also note the Search/Fetch ceilings are per account, so a key pool only adds headroom if each key is a separate TinyFish account. Notable behavior A failed automation is an HTTP 200 with the failure inside the run, so success comes from the run's own status. The structured error (code, category, retryAfter, helpUrl) is exposed as an output so a workflow can branch without parsing a message string. goal and outputSchema are declared as request.modelInput — TinyFish hands the goal to the agent's LLM verbatim and re-prompts that model with the schema on a mismatch (schema_validation.re_prompt_attempts counts exactly those passes). The target URL, proxy settings, and vault scoping stay ordinary request inputs. list_vault_items returns display-safe metadata only. It exists so the credential URIs credentialItemIds demands are discoverable in-product; secret values never leave TinyFish. Fetch enforces the documented 1–10 URL bound locally so the failure names itself instead of surfacing a generic 400. The icon is TinyFish's official mark, which they publish only as a raster — embedded as a base64 PNG in an SVG wrapper, the same pattern GoogleIcon already uses in that file. Type of Change New feature Testing 44 unit tests covering request-body construction, every response mapping, the FAILED-200 path, error-envelope extraction, model-input projection, hosted-key pricing and rate-limit dimensions, and block wiring. Verified they fail without their fixes. bun run type-check, bun run lint, and all 36 check:audits gates pass, including docs:check, tool-metadata:check, integration-catalog:check, and check:api-validation:strict. Validated with 3 parallel audit passes against the OpenAPI specs (wire correctness), block↔tool alignment, and hosted-key/provenance conventions; findings from all three are folded in. Not exercised against a live TinyFish key — the account key is being added separately. 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)

Open Graph Description: Summary Adds the TinyFish integration: 8 tools, a block, the brand icon, and hosted-key support. Built against TinyFish's published OpenAPI specs (agent/search/fetch), not prose docs — every r...

X Description: Summary Adds the TinyFish integration: 8 tools, a block, the brand icon, and hosted-key support. Built against TinyFish's published OpenAPI specs (agent/search/fetch), not prose docs — eve...

Opengraph URL: https://github.com/simstudioai/sim/pull/7177

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react-reconciler,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@d5750093facf
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:1ae15266-01d4-af9d-4e52-7c3b0bb0e7af
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idD7EA:7BAD7:1FC7D:2B395:6AFB26FF
html-safe-nonce4cd6f3290a26a3145881ba3905b79564d13e04ff1464e45c27393b001445f356
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEN0VBOjdCQUQ3OjFGQzdEOjJCMzk1OjZBRkIyNkZGIiwidmlzaXRvcl9pZCI6IjM3NTk4Njc2NzMyNTczODc3NzUiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac6f164682a919d9a43bd4cc7f68706e0525b1adf1b0639113446467a1022a4301
hovercard-subject-tagpull_request:4379918069
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/simstudioai/sim/pull/7177/files
twitter:imagehttps://avatars.githubusercontent.com/u/40672544?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/40672544?s=400&v=4
og:image:altSummary Adds the TinyFish integration: 8 tools, a block, the brand icon, and hosted-key support. Built against TinyFish's published OpenAPI specs (agent/search/fetch), not prose docs — every r...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None40c7ffe00e8bbb3ca8403c83d7ef110379c9eba2cbc7a7c333b037ffd940d4e4
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/simstudioai/sim git https://github.com/simstudioai/sim.git
octolytics-dimension-user_id199344406
octolytics-dimension-user_loginsimstudioai
octolytics-dimension-repository_id912559512
octolytics-dimension-repository_nwosimstudioai/sim
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id912559512
octolytics-dimension-repository_network_root_nwosimstudioai/sim
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
releasef494d77c37809e03e18d49c6e9945c57e0b64070
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/simstudioai/sim/pull/7177/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fsimstudioai%2Fsim%2Fpull%2F7177%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fsimstudioai%2Fsim%2Fpull%2F7177%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=simstudioai%2Fsim
Reloadhttps://github.com/simstudioai/sim/pull/7177/files
Reloadhttps://github.com/simstudioai/sim/pull/7177/files
Reloadhttps://github.com/simstudioai/sim/pull/7177/files
simstudioaihttps://github.com/simstudioai
simhttps://github.com/simstudioai/sim
Codehttps://github.com/simstudioai/sim
Issues129 (129)https://github.com/simstudioai/sim/issues
Pull requests198 (198)https://github.com/simstudioai/sim/pulls
Actionshttps://github.com/simstudioai/sim/actions
Projectshttps://github.com/simstudioai/sim/projects
Security and qualityhttps://github.com/simstudioai/sim/security
Insightshttps://github.com/simstudioai/sim/pulse
Sign up for GitHub https://github.com/signup?return_to=%2Fsimstudioai%2Fsim%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fsimstudioai%2Fsim%2Fissues%2Fnew%2Fchoose
waleedlatif1https://github.com/waleedlatif1
staginghttps://github.com/simstudioai/sim/tree/staging
feat/tinyfish-integrationhttps://github.com/simstudioai/sim/tree/feat/tinyfish-integration
Conversation 20 https://github.com/simstudioai/sim/pull/7177
Commits 3 https://github.com/simstudioai/sim/pull/7177/commits
Checks 32 https://github.com/simstudioai/sim/pull/7177/checks
Files changed https://github.com/simstudioai/sim/pull/7177/files
Please reload this pagehttps://github.com/simstudioai/sim/pull/7177/files
feat(tinyfish): add TinyFish web agent, search, and fetch integration https://github.com/simstudioai/sim/pull/7177/files#top
Show all changes 3 commits https://github.com/simstudioai/sim/pull/7177/files
4ada9e8 feat(tinyfish): add TinyFish web agent, search, and fetch integration waleedlatif1 Aug 27, 2026 https://github.com/simstudioai/sim/pull/7177/commits/4ada9e81e126fd0750defd4efc0170698c3104d1
b10c356 fix(tinyfish): address review findings waleedlatif1 Aug 27, 2026 https://github.com/simstudioai/sim/pull/7177/commits/b10c356762b1c070fba7321a66e21ff36a05e277
e56d567 chore(byok): audit that every hosted provider is fully wired waleedlatif1 Aug 27, 2026 https://github.com/simstudioai/sim/pull/7177/commits/e56d5671b2838fc78c165607e206195b527a9531
Clear filters https://github.com/simstudioai/sim/pull/7177/files
Please reload this pagehttps://github.com/simstudioai/sim/pull/7177/files
Please reload this pagehttps://github.com/simstudioai/sim/pull/7177/files
icons.tsx https://github.com/simstudioai/sim/pull/7177/files#diff-ad82ea6f4020b7b9555fc40c56c93b82fb246b727c105f8e1e0da9c03dc49274
icon-mapping.ts https://github.com/simstudioai/sim/pull/7177/files#diff-193abeb0603365b837c7d5ba8637be7ef998dde35d5746dfb8fa954fe8b1fcaa
meta.json https://github.com/simstudioai/sim/pull/7177/files#diff-59d7506ddfe264c889aa27abd55383fa1815c385f9e008f02aebc41c2d9819ff
tinyfish.mdx https://github.com/simstudioai/sim/pull/7177/files#diff-7de0cca03bf9b2dd25bbe73f53bc1266370a44d7722a83b7b0d5a537da1e6072
byok.tsx https://github.com/simstudioai/sim/pull/7177/files#diff-e946fa2c5a88e3daae6dc6cf880006fa3d456088838b1066e005b5f0bf7b90c4
tinyfish.ts https://github.com/simstudioai/sim/pull/7177/files#diff-85e2d34578daae8dcab161160692be315be74d701ab1ad72c5b333d75d385b60
registry-maps.ts https://github.com/simstudioai/sim/pull/7177/files#diff-989c47910e6b401eace95892b8e5119d99351912cc66928fe7dffcbaa6e086d7
icons.tsx https://github.com/simstudioai/sim/pull/7177/files#diff-75502961b6b1b69fd8b140643edfe13c66790af9f167e9a545cbcff6b2e9a20d
byok-keys.ts https://github.com/simstudioai/sim/pull/7177/files#diff-854487f923924fdef28627b30572d311684f281f4a6203ab4d5729a2a96343af
docs-manifest.ts https://github.com/simstudioai/sim/pull/7177/files#diff-48dc312f04c047aa9e506b6b3e8ae7f85bd60434594e50cc1c0a941879b0875d
icon-mapping.ts https://github.com/simstudioai/sim/pull/7177/files#diff-31b9f59a480a2b6cc7d98ac5076f304e142b3a42be1ef966bfebd4643ba8c7af
tool-ids.ts https://github.com/simstudioai/sim/pull/7177/files#diff-fde8cbb4483aa4a8015ca3e576ab1c9b472d1c97c521fa67e81b469a5297bdfb
tool-metadata.ts https://github.com/simstudioai/sim/pull/7177/files#diff-3a953213cad2b14799015043b75c22cd4815397d3a43ccbf138816bedfdfccd7
tool-outputs.ts https://github.com/simstudioai/sim/pull/7177/files#diff-9fd709d7ce13d883503da15dae272e6c0a0a4fc25d7ec475f4ce6875c097b6aa
registry.ts https://github.com/simstudioai/sim/pull/7177/files#diff-a05e54887bf05477726b00df4183dd4a3fa0fd1f82b867bbf156e1b6a6d7e3fa
cancel_run.ts https://github.com/simstudioai/sim/pull/7177/files#diff-c8107833c1b01f918edf14c28bef5f68e37222f881dedfa0f19648fb39f71e65
fetch_urls.ts https://github.com/simstudioai/sim/pull/7177/files#diff-74d862a56ab69fde362af5bc2021ec212a9ddba705e1afc593a8e6912d8b2b2c
get_run.ts https://github.com/simstudioai/sim/pull/7177/files#diff-df4d12a4f4c2194cca351e6bee6a3cff4b8cb839d4fc47922702d49ac4595b68
hosting.ts https://github.com/simstudioai/sim/pull/7177/files#diff-08df51f8153ec0bc600ad781f7158ade53594cd66a8dd45edfbe3c967db2dfc5
index.ts https://github.com/simstudioai/sim/pull/7177/files#diff-622ce9ec3fb6d1fd1e61ae87edd55c5eea66acfa27c99016a4434be76964acba
list_runs.ts https://github.com/simstudioai/sim/pull/7177/files#diff-c2930b25aa246efff4fb48b39d6ad1470ac2195504006689d803b107f2faebcb
list_vault_items.ts https://github.com/simstudioai/sim/pull/7177/files#diff-25fa8daa1fc38456ab3fdfcfac74d0ebdb95ac56ada66ec97cdc288ea21f3129
run.ts https://github.com/simstudioai/sim/pull/7177/files#diff-c5c2226e955692a9eef6cddda615daac16f795df49e44a1e20dca4aa2118564e
run_async.ts https://github.com/simstudioai/sim/pull/7177/files#diff-b0f32573c9a6f018cb3a482f2316488338f5897cb628d4cd989c67f12fdae405
search.ts https://github.com/simstudioai/sim/pull/7177/files#diff-a7beb78f861b3539f1946b011b853d793b30d9526891665b2862e57d21498711
tinyfish.test.ts https://github.com/simstudioai/sim/pull/7177/files#diff-f0519c2fee808b06f4d5cc46c6b83d555c476fc01bf3510596258740fe46194c
types.ts https://github.com/simstudioai/sim/pull/7177/files#diff-4bd4b201e17f347dfee400caea2e3b59cf468a55a3752f82efa969fa4f129291
utils.ts https://github.com/simstudioai/sim/pull/7177/files#diff-33c9d73978ee991e81cd815dbbd0d736136b00f2f88926fc4b6fafa6710c2979
types.ts https://github.com/simstudioai/sim/pull/7177/files#diff-183540ce4359174673a854639c5032c16e740cb4951781bf2591b50f1cb68fac
package.json https://github.com/simstudioai/sim/pull/7177/files#diff-7ae45ad102eab3b6d7e7896acd08c427a9b25b346470d7bc6507b6481575d519
integrations.json https://github.com/simstudioai/sim/pull/7177/files#diff-3c0cdbab0250ae3bd5869a2c3ce5c3f4f548d896e4fbbbc82a01ffc0f588a8cc
check-byok-providers.ts https://github.com/simstudioai/sim/pull/7177/files#diff-9f1510264f8b37af44c3649d14fed95fd2658563e07b5989a083ed16e284ce80
apps/docs/components/icons.tsxhttps://github.com/simstudioai/sim/pull/7177/files#diff-ad82ea6f4020b7b9555fc40c56c93b82fb246b727c105f8e1e0da9c03dc49274
View file https://github.com/simstudioai/sim/blob/e56d5671b2838fc78c165607e206195b527a9531/apps/docs/components/icons.tsx
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/simstudioai/sim/pull/7177/{{ revealButtonHref }}
https://github.com/simstudioai/sim/pull/7177/files#diff-ad82ea6f4020b7b9555fc40c56c93b82fb246b727c105f8e1e0da9c03dc49274
https://github.com/simstudioai/sim/pull/7177/files#diff-ad82ea6f4020b7b9555fc40c56c93b82fb246b727c105f8e1e0da9c03dc49274
apps/docs/components/ui/icon-mapping.tshttps://github.com/simstudioai/sim/pull/7177/files#diff-193abeb0603365b837c7d5ba8637be7ef998dde35d5746dfb8fa954fe8b1fcaa
View file https://github.com/simstudioai/sim/blob/e56d5671b2838fc78c165607e206195b527a9531/apps/docs/components/ui/icon-mapping.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/simstudioai/sim/pull/7177/{{ revealButtonHref }}
https://github.com/simstudioai/sim/pull/7177/files#diff-193abeb0603365b837c7d5ba8637be7ef998dde35d5746dfb8fa954fe8b1fcaa
https://github.com/simstudioai/sim/pull/7177/files#diff-193abeb0603365b837c7d5ba8637be7ef998dde35d5746dfb8fa954fe8b1fcaa
https://github.com/simstudioai/sim/pull/7177/files#diff-193abeb0603365b837c7d5ba8637be7ef998dde35d5746dfb8fa954fe8b1fcaa
https://github.com/simstudioai/sim/pull/7177/files#diff-193abeb0603365b837c7d5ba8637be7ef998dde35d5746dfb8fa954fe8b1fcaa
apps/docs/content/docs/en/integrations/meta.jsonhttps://github.com/simstudioai/sim/pull/7177/files#diff-59d7506ddfe264c889aa27abd55383fa1815c385f9e008f02aebc41c2d9819ff
View file https://github.com/simstudioai/sim/blob/e56d5671b2838fc78c165607e206195b527a9531/apps/docs/content/docs/en/integrations/meta.json
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/simstudioai/sim/pull/7177/{{ revealButtonHref }}
https://github.com/simstudioai/sim/pull/7177/files#diff-59d7506ddfe264c889aa27abd55383fa1815c385f9e008f02aebc41c2d9819ff
https://github.com/simstudioai/sim/pull/7177/files#diff-59d7506ddfe264c889aa27abd55383fa1815c385f9e008f02aebc41c2d9819ff
Please reload this pagehttps://github.com/simstudioai/sim/pull/7177/files
Please reload this pagehttps://github.com/simstudioai/sim/pull/7177/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.