René's URL Explorer Experiment


Title: feat(files): live presence avatars + live file tree [3/N] by waleedlatif1 · Pull Request #5932 · simstudioai/sim · GitHub

Open Graph Title: feat(files): live presence avatars + live file tree [3/N] by waleedlatif1 · Pull Request #5932 · simstudioai/sim

X Title: feat(files): live presence avatars + live file tree [3/N] by waleedlatif1 · Pull Request #5932 · simstudioai/sim

Description: Realtime Rooms — Phase 3 of N (Files feature) Stacked on #5930. Files becomes the first adopter of the shared presence room: collaborator avatars in the Files header and a live-updating file tree. File mutations are unchanged (still HTTP) — the socket only carries presence + a lossy change signal. Server (apps/realtime) handlers/workspace-files.ts — join/leave the workspace-files room (room id = workspaceId), authorized via the shared authorizeRoom. Its own event names (join-workspace-files*, workspace-files:presence-update), never the workflow ones. POST /api/workspace-files-changed — internal-key-gated fan-out that broadcasts workspace-files-changed to the room (mirrors the existing workflow-* endpoints). Fan-out (apps/sim) lib/realtime/notify.ts — best-effort, timeout-bounded notify; never throws (a dropped signal only degrades to stale-until-refetch, today's behavior). Wired into all 8 perform* file/folder lifecycle functions (the shared seam — covers routes and copilot tools) plus the upload-register path. Client (apps/sim) Shared extracted so the Files header and the workflow sidebar render identical avatar stacks. use-workspace-files-room — joins on connect, tracks presence, and calls invalidateWorkspaceFileBrowsers on workspace-files-changed. Avatars render in the Resource header aside slot (the sanctioned supplementary-content slot, same location pattern as the table editor's controls). Placement decision Workflow avatars live in the sidebar list item (the workflow editor is a canvas, not a Resource page). Files is a Resource page, so its avatars go in the Resource header aside — using the same shared component, so both surfaces render identically. Cursors Deferred to a focused follow-up: pointer cursors over a scrolling, virtualized file list need content-space (scroll-synced) coordinates that must be verified live in two browsers. Shipping unverified cursor math would risk exactly the "desync on scroll" side effect we want to avoid. Avatars are the standard file-browser presence indicator (Drive/Dropbox) and are fully robust here. Verification +4 Files-handler tests (auth-required, unavailable, access-denied, join success). Realtime 124 tests pass. Both apps tsc --noEmit clean; check:api-validation ✅; boundaries + prune ✅. 🤖 Generated with Claude Code

Open Graph Description: Realtime Rooms — Phase 3 of N (Files feature) Stacked on #5930. Files becomes the first adopter of the shared presence room: collaborator avatars in the Files header and a live-updating file tree. ...

X Description: Realtime Rooms — Phase 3 of N (Files feature) Stacked on #5930. Files becomes the first adopter of the shared presence room: collaborator avatars in the Files header and a live-updating file tree. ...

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

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:946b26ad-e59d-8ae3-fa91-f11f3dcb42cd
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idE42E:1BB36A:B27917:F4B5C2:6AFB50B5
html-safe-nonce59e3330f1258e82d82b6e8b0bcd13f96459c2eab2c32526f79a96945fc27be56
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFNDJFOjFCQjM2QTpCMjc5MTc6RjRCNUMyOjZBRkI1MEI1IiwidmlzaXRvcl9pZCI6IjYyNTI0MzY4ODk2MzA2MjU5NzMiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmacd1ec282ea8902c3162091ea5bb9bc206b1afb678a33d69b4441aecf6aaf80892
hovercard-subject-tagpull_request:4127037669
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/5932/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:altRealtime Rooms — Phase 3 of N (Files feature) Stacked on #5930. Files becomes the first adopter of the shared presence room: collaborator avatars in the Files header and a live-updating file tree. ...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None7122bb414b542dba14d71a3f0b9f6fd2abce715b9f5912d082800563e6c806d1
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
releasecbf66c024bb6d10e6955baa7413c54cf13a201bb
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/simstudioai/sim/pull/5932/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fsimstudioai%2Fsim%2Fpull%2F5932%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%2F5932%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/5932/files
Reloadhttps://github.com/simstudioai/sim/pull/5932/files
Reloadhttps://github.com/simstudioai/sim/pull/5932/files
simstudioaihttps://github.com/simstudioai
simhttps://github.com/simstudioai/sim
Codehttps://github.com/simstudioai/sim
Issues129 (129)https://github.com/simstudioai/sim/issues
Pull requests197 (197)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
realtime-roomshttps://github.com/simstudioai/sim/tree/realtime-rooms
realtime-rooms-phase2-fileshttps://github.com/simstudioai/sim/tree/realtime-rooms-phase2-files
Conversation 12 https://github.com/simstudioai/sim/pull/5932
Commits 1 https://github.com/simstudioai/sim/pull/5932/commits
Checks 2 https://github.com/simstudioai/sim/pull/5932/checks
Files changed https://github.com/simstudioai/sim/pull/5932/files
Please reload this pagehttps://github.com/simstudioai/sim/pull/5932/files
feat(files): live presence avatars + live file tree [3/N] https://github.com/simstudioai/sim/pull/5932/files#top
Show all changes 1 commit https://github.com/simstudioai/sim/pull/5932/files
49604b7 feat(files): live presence avatars + live file tree via realtime rooms waleedlatif1 Jul 24, 2026 https://github.com/simstudioai/sim/pull/5932/commits/49604b756b75d2177acc663f48af283987f157d5
Clear filters https://github.com/simstudioai/sim/pull/5932/files
Please reload this pagehttps://github.com/simstudioai/sim/pull/5932/files
Please reload this pagehttps://github.com/simstudioai/sim/pull/5932/files
index.ts https://github.com/simstudioai/sim/pull/5932/files#diff-d75833a2f129b649d1250577a473393fadbee1f55f24ed607a0b7d77b511af59
workspace-files.test.ts https://github.com/simstudioai/sim/pull/5932/files#diff-388fdd5e6e1fa974aa526d25013b17b0247438fa08ed407f1524c05acd5841b5
workspace-files.ts https://github.com/simstudioai/sim/pull/5932/files#diff-084fa627c9e97a3928b4a3f7142e5f07cd55343416f5d15b1786afe432f6f5ca
types.ts https://github.com/simstudioai/sim/pull/5932/files#diff-731dbe0d0091b1ff63c25da26d7f6c0444b9666dcb619d8b31bda8208bea7882
http.ts https://github.com/simstudioai/sim/pull/5932/files#diff-a5f2abd44fc0dacfd92a32198bd0b16f6692b98b4fda17c9ebfde27f36c3f8b9
route.ts https://github.com/simstudioai/sim/pull/5932/files#diff-da5e48f517e89fc766350742eb7881a818a74c9a345d96924a5c588adcbf42c1
presence-avatars.tsx https://github.com/simstudioai/sim/pull/5932/files#diff-9a369f30fc2875f1405fd45a8c5044e46a6a033ac3439603e703cb39c106cf1d
files.tsx https://github.com/simstudioai/sim/pull/5932/files#diff-0284e2e46ba0636bd37fb01a0bee2a53844af9bbaf0a5879e3b182c0f34e67a9
use-workspace-files-room.ts https://github.com/simstudioai/sim/pull/5932/files#diff-141bf4f4babf802e435a0b949cd4187dc1d64cd3c6ebc6fc845d49fc98cf8faf
avatars.tsx https://github.com/simstudioai/sim/pull/5932/files#diff-c87c294983f4e143c8cb3018a277c269d7e38b2a1361236e71a0705b7dc353b3
workspace-file-folders.ts https://github.com/simstudioai/sim/pull/5932/files#diff-7f919b42006635de731f24e6cc0cbff144fc0d0dd583db6010e20006d742099b
notify.ts https://github.com/simstudioai/sim/pull/5932/files#diff-1ac32e0ce2f0dadf626f5b0e889359d428bd7a3870fe52a15e2210a8d78287ac
file-folder-lifecycle.ts https://github.com/simstudioai/sim/pull/5932/files#diff-093d25b0c251d88237399b2808c5daefad838b5ed28e8754a6b60b182ab71d64
apps/realtime/src/handlers/index.tshttps://github.com/simstudioai/sim/pull/5932/files#diff-d75833a2f129b649d1250577a473393fadbee1f55f24ed607a0b7d77b511af59
View file https://github.com/simstudioai/sim/blob/49604b756b75d2177acc663f48af283987f157d5/apps/realtime/src/handlers/index.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/simstudioai/sim/pull/5932/{{ revealButtonHref }}
https://github.com/simstudioai/sim/pull/5932/files#diff-d75833a2f129b649d1250577a473393fadbee1f55f24ed607a0b7d77b511af59
https://github.com/simstudioai/sim/pull/5932/files#diff-d75833a2f129b649d1250577a473393fadbee1f55f24ed607a0b7d77b511af59
apps/realtime/src/handlers/workspace-files.test.tshttps://github.com/simstudioai/sim/pull/5932/files#diff-388fdd5e6e1fa974aa526d25013b17b0247438fa08ed407f1524c05acd5841b5
View file https://github.com/simstudioai/sim/blob/49604b756b75d2177acc663f48af283987f157d5/apps/realtime/src/handlers/workspace-files.test.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/simstudioai/sim/pull/5932/{{ revealButtonHref }}
apps/realtime/src/handlers/workspace-files.tshttps://github.com/simstudioai/sim/pull/5932/files#diff-084fa627c9e97a3928b4a3f7142e5f07cd55343416f5d15b1786afe432f6f5ca
View file https://github.com/simstudioai/sim/blob/49604b756b75d2177acc663f48af283987f157d5/apps/realtime/src/handlers/workspace-files.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/simstudioai/sim/pull/5932/{{ revealButtonHref }}
cursorhttps://github.com/apps/cursor
Jul 24, 2026https://github.com/simstudioai/sim/pull/5932/files#r3647662642
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
apps/realtime/src/handlers/workspace-files.ts#L105-L115https://github.com/simstudioai/sim/blob/97f5ce87c6dec4dd23b7555d96aaf68092c427e3/apps/realtime/src/handlers/workspace-files.ts#L105-L115
https://cursor.com/open?link=eyJ2ZXJzaW9uIjoxLCJ0eXBlIjoiQlVHQk9UX0ZJWF9JTl9DVVJTT1IiLCJkYXRhIjp7InJlZGlzS2V5IjoiYnVnYm90OjE4YWM1NzYwLWI1M2EtNGYzYi05MTRmLTI4MTQ5ZTRmYjQ2ZiIsImVuY3J5cHRpb25LZXkiOiJxc3lRclM5Y092aFNEMWdzSE1NMDRaZW0wbXgyWTJiNHVISlRtbjZpaXZRIiwiYnJhbmNoIjoicmVhbHRpbWUtcm9vbXMtcGhhc2UyLWZpbGVzIiwicmVwb093bmVyIjoic2ltc3R1ZGlvYWkiLCJyZXBvTmFtZSI6InNpbSJ9fQ
https://cursor.com/agents?link=eyJ2ZXJzaW9uIjoxLCJ0eXBlIjoiQlVHQk9UX0ZJWF9JTl9XRUIiLCJkYXRhIjp7InJlZGlzS2V5IjoiYnVnYm90OjE4YWM1NzYwLWI1M2EtNGYzYi05MTRmLTI4MTQ5ZTRmYjQ2ZiIsImVuY3J5cHRpb25LZXkiOiJxc3lRclM5Y092aFNEMWdzSE1NMDRaZW0wbXgyWTJiNHVISlRtbjZpaXZRIiwiYnJhbmNoIjoicmVhbHRpbWUtcm9vbXMtcGhhc2UyLWZpbGVzIiwicmVwb093bmVyIjoic2ltc3R1ZGlvYWkiLCJyZXBvTmFtZSI6InNpbSIsInByTnVtYmVyIjo1OTMyLCJjb21taXRTaGEiOiI5N2Y1Y2U4N2M2ZGVjNGRkMjNiNzU1NWQ5NmFhZjY4MDkyYzQyN2UzIiwicHJvdmlkZXIiOiJnaXRodWIifX0
Cursor Bugbothttps://cursor.com/bugbot
97f5ce8https://github.com/simstudioai/sim/commit/97f5ce87c6dec4dd23b7555d96aaf68092c427e3
herehttps://www.cursor.com/dashboard/bugbot
Please reload this pagehttps://github.com/simstudioai/sim/pull/5932/files
apps/realtime/src/rooms/types.tshttps://github.com/simstudioai/sim/pull/5932/files#diff-731dbe0d0091b1ff63c25da26d7f6c0444b9666dcb619d8b31bda8208bea7882
View file https://github.com/simstudioai/sim/blob/49604b756b75d2177acc663f48af283987f157d5/apps/realtime/src/rooms/types.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/simstudioai/sim/pull/5932/{{ revealButtonHref }}
https://github.com/simstudioai/sim/pull/5932/files#diff-731dbe0d0091b1ff63c25da26d7f6c0444b9666dcb619d8b31bda8208bea7882
https://github.com/simstudioai/sim/pull/5932/files#diff-731dbe0d0091b1ff63c25da26d7f6c0444b9666dcb619d8b31bda8208bea7882
Please reload this pagehttps://github.com/simstudioai/sim/pull/5932/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.