Skip to content

feat(files): workflow-backed HTML dashboards - #8156

Draft
TheodoreSpeaks wants to merge 8 commits into
stagingfrom
codex/investigate-workflow-backed-sim-files
Draft

TheodoreSpeaks wants to merge 8 commits into
stagingfrom
codex/investigate-workflow-backed-sim-files

Conversation

@TheodoreSpeaks

@TheodoreSpeaks TheodoreSpeaks commented Sep 22, 2026 •

Copy link
Copy Markdown
Collaborator

HTML workspace files can declare deployed workflow IDs and call them from isolated HTML or file-specific APIs. Calls accept only declared JSON input fields, run synchronously, and appear in workflow logs as File while using the deployed API input block. The browser document receives a narrow MessagePort API, never a Sim cookie or credential; existing public-share authentication still applies.

The admission cache is keyed by file, workflow, audience, and canonical input. The same input reuses its result for five minutes, and a no-input workflow has one cache key. A separate 20-run-per-file/workflow five-minute budget bounds distinct-input fan-out. Successful output remains in Redis for five minutes. The v2 API, generated CLI/MCP operations, Copilot file tool, and HTML bridge can run with input and read that input's cached result without putting values in a URL. A paused run may finish in normal workflow history without republishing its eventual output to this cache.

research/workflow-backed-html-table-query-design.md contains the full design for read-only table queries from private and public HTML file shares. Table grants, routes, and browser API are design-only in this PR.

Validation: Sim and CLI type checks; 79 focused unit tests; nine PostgreSQL migration/admission tests against a disposable local database; API boundary, migration, OpenAPI, CLI/MCP generation, and Biome checks. See research/workflow-backed-html-dashboards.md for behavior and setup.

Target: staging. Apply additive migration 0377_flaky_quicksilver.sql with the Sim rollout before enabling the companion Mothership tool in PR #513. Configure HTML_CONTENT_ORIGIN per environment; production's intended host is https://file.simstudio.ai, with TLS and ingress limited to /html-frame. This draft PR does not authorize a merge or production deployment.

@vercel

vercel Bot commented Sep 22, 2026 •

Copy link
Copy Markdown

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

1 Skipped Deployment
Project Deployment Actions Updated
docs Skipped Skipped Sep 23, 2026 12:17am UTC

Request Review

…logs

Add an explicit read-only table-query design for HTML files and public shares.

This branch was previously deployed

1 inactive deployment
Preview — 6af4c9b2 Deployed Sep 23, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant