Desktop: blueprint view by jeff-hykin · Pull Request #4506 · dimensionalOS/dimos

jeff-hykin · 2026-10-10T01:46:24Z

Gateway API 9.0: catalog source routes, msgs.js, the cloud login page and login?after= (the blueprint view itself is now Desktop's).

github-actions

go2 replay realtime (arm64)

Details

Benchmark suite	Current: `5eafc02`	Previous: `5bc57a0`	Ratio
`peak memory`	`1744.953` MB	`1776.91` MB	`0.98`
`peak threads`	`367` threads	`376` threads	`0.98`
`network (transport)`	`2733.72` MB	`2730.972` MB	`1.00`
`disk write`	`1.828` MB	`1.59` MB	`1.15`
`instructions`	`137.199` G	`138.52` G	`0.99`

This comment was automatically generated by workflow using github-action-benchmark.

codecov · 2026-10-10T01:54:39Z

⚠️ JUnit XML file not found

The CLI was unable to find any JUnit XML files to upload.
For more help, visit our troubleshooting guide.

…s nothing, dimos:visible pauses or refreshes + resumes the runs, topic-rate and log polls, and dimos:chrome says pausable (dimos-react 0.2.1)

…e too coarse to see a quick edit

# Conflicts: # .github/workflows/ci.yml # dimos.yaml

…ns prose, drop a blueprint main deleted

… the whole web workspace

…eprint rescan, modules, skills, robots, msgs), /config, and /runs (module, skill, exec, live skills, logs)

# Conflicts: # dimos.yaml # experimental/gateway/README.md # experimental/gateway/app.py

# Conflicts: # experimental/gateway/app.py

…e 5.0 routes

…ets for each module field (value)

The console-preview fixes (h264 cameras, opening an .mcap at all) landed here by accident of where they were written. They are not about the cloud endpoints and they do not belong in this PR; they continue on their own branch.

…outError

…ff/feat/blueprint_view # Conflicts: # experimental/gateway/constants.py

…a missing schema shows lcm_codec's own error

…og or the launch output grows

…gs (blueprint-view:), served in GET /config

…, so the login page waits instead of polling

…t, timers only from config

…ments (CollectionModule's input_types answered 500)

…deQL polynomial-regex alert)

greptile-apps · 2026-11-10T17:24:31Z

Confidence Score: 3/5

[Medium impact] The changes reach Desktop’s gateway pages and their supporting API workflows.

Fix the lost-settings race and Linux wheel build before merging.

Findings

Quick edits lose saved settings ▶
Linux wheels fail to build ▶

Summary

Adds the blueprint graph, configuration dialog, live logs and process details, plus source-file, message-decoder and embedded login routes.

Desktop can open a Blueprint view to explore and control a blueprint.
Apps can embed a page that starts or cancels a Dimensional cloud login.
Browser pages can load dimos LCM message decoders from the gateway.
Catalog entries now show the abilities linked to their modules.
Gateway pages refresh their data when runs, logs, or shared settings change.
A pinned gateway can inspect and run blueprints from a separate checkout.
Gateway builds now include the Blueprint view and its browser assets.

_{Reviews (2) · Last reviewed commit: "gateway: a run's logs say watched: false..." · Reviewed by Greptile}

# Conflicts: # docs/usage/gateway.md # experimental/gateway/app.py # experimental/gateway/responses.py # experimental/gateway/routes/cloud.py # experimental/gateway/shared_config.py # experimental/gateway/state.py # experimental/gateway/tests/test_cloud.py # experimental/gateway/uploads.py

…printView and ?loginNot= in dimos.yaml and the docs

…han launches.py's dimos imports can still list blueprint configs (DIM-630: every /config was a 500)

…ship, so a pip-installed gateway serves /blueprint_view and /msgs.js

… global overrides (they win at launch) instead of the shared value under them, and a module field saved as null shows null, not its default

… process stats and Stop

… blueprint's live run came from, as the catalog reads its modules (Show code from a branch run)

…s/ folders the gateway watches (a third checkout), and the logs dialog polls those instead of waiting on log events; API 8.6.0

mustafab0 · 2026-11-10T22:16:53Z

@greptile review

greptile-apps · 2026-11-10T22:22:23Z

+  const setField = (spec: FieldSpec, value: unknown) =>
+    save(() => {
+      const atBase = sameValue(value, spec.base);
+      if (spec.scope === "module") {
+        return saveModules(withModule(savedModules, spec, atBase ? undefined : value));


Quick edits lose saved settings

Editing two settings before the first save finishes can silently discard the first edit. Each call builds a complete settings dictionary from the last server response, so the second request leaves out the first change. The next launch then uses settings the user did not intend.

Queue saves and apply each edit to the latest saved values, or block further edits until the save finishes.

greptile-apps · 2026-11-10T22:22:23Z

+        deno = shutil.which("deno")
+        if (app / "src").is_dir() and deno:
+            # built here every time: a dist left by an older checkout would ship stale
+            subprocess.run([deno, "install", "--frozen"], cwd=app, check=True)
+            subprocess.run(
+                [deno, "run", "--frozen", "-A", "npm:vite", "build"], cwd=app, check=True
+            )
+        if not (app / "dist" / "index.html").is_file():
+            if os.environ.get("DIMOS_ALLOW_MISSING_COCKPIT") != "1":
+                raise RuntimeError(


Linux wheels fail to build

The Linux release wheels now require Deno inside the build container, but the release workflow installs it only on the host. The existing build action builds web/sdk and web/cockpit, not blueprint_view. When cibuildwheel runs this hook in its manylinux container, neither Deno nor the new page's built files are available. This raises an error and stops the wheel build.

Build the page before entering the container and preserve its output, or install Deno inside the container.

I agree with this.

My use of setup.py for the cockpit is also a mistake. I never got around to fixing that.

Agreed—the same packaging concern applies to the cockpit build, so fixing only blueprint_view would leave the underlying setup.py coupling in place. Thanks for the context.

paul-nechifor · 2026-11-10T22:33:53Z

+    if (app / "src").is_dir():
+        # the same lock file relay_process uses, held until another process's build ends however long it takes
+        with (app / ".build.lock").open("w") as lock_file:
+            fcntl.flock(lock_file, fcntl.LOCK_EX)


Use filelock. We already have it installed.

paul-nechifor · 2026-11-10T22:41:05Z

+Decode dimos messages in a page with `msgs.js`:
+
+```js
+const app = new DimApp({ msgDecodeEndpoint: "../../dimos-gateway/msgs.js" }) // DimApp from ./dim-app/mod.js


What is DimApp?

paul-nechifor · 2026-11-10T22:55:06Z

    /docs/search:
      get:
        summary: Redirects to the docs site with its search open on ?q= (for a new tab or an iframe)
+    /blueprint_view:


View is an overloaded term is software development. I'd call it details to make it clearer.

In fact, it would probably be better as:

/blueprints/{identifier}/details

paul-nechifor · 2026-11-10T23:03:00Z

+    "react-dom/": "npm:/react-dom@^19.2.0/",
+    "@types/react": "npm:@types/react@^19.3.0",
+    "@types/react-dom": "npm:@types/react-dom@^19.3.0",
+    "dimos-react": "https://raw.githubusercontent.com/jeff-hykin/dimos-react/v0.3.6/src/index.ts",


Again, package should be in dimensional

… /config or its config events; its timers are Desktop settings), GET /source becomes /catalog/blueprints/{name}/source and /catalog/modules/{name}/source?blueprint=, and /cloud/account?loginNot= becomes GET /cloud/login?after=, per the dimos-gateway plan; a blueprint's modules can be ?fields= picked; API 9.0.0

…copy of the module class lacks them (an RPC added in the run's checkout), and restart/stop no longer import the class; API 9.0.1

…ks (Desktop now runs the run's checkout's own gateway instead); API 9.0.2

github-actions Bot reviewed Oct 10, 2026

View reviewed changes

jeff-hykin had a problem deploying to cachix October 13, 2026 19:06 — with GitHub Actions Error

jeff-hykin temporarily deployed to cachix October 13, 2026 19:06 — with GitHub Actions Inactive

jeff-hykin temporarily deployed to cachix October 15, 2026 07:48 — with GitHub Actions Inactive

jeff-hykin changed the title ~~dimos gateway: blueprint view, msgs.js and the cloud login page~~ desktop: blueprint view Oct 15, 2026

jeff-hykin changed the base branch from jeff/feat/dimos_server to jeff/feat/gateway_cloud October 15, 2026 21:01

greptile-apps Bot mentioned this pull request Oct 15, 2026

Desktop: gateway cloud endpoints #4597

Merged

jeff-hykin added 2 commits October 15, 2026 18:26

Merge jeff/feat/dimos_server (API 4.1.0) into jeff/feat/gateway_cloud

f1890fd

Merge jeff/feat/gateway_cloud (API 4.1.0) into jeff/feat/blueprint_view

c3f9de3

jeff-hykin temporarily deployed to cachix October 16, 2026 01:27 — with GitHub Actions Inactive

blueprint view: &hidden=1 (Desktop preloading it) loads once and poll…

feb50e2

…s nothing, dimos:visible pauses or refreshes + resumes the runs, topic-rate and log polls, and dimos:chrome says pausable (dimos-react 0.2.1)

jeff-hykin temporarily deployed to cachix October 17, 2026 07:55 — with GitHub Actions Inactive

jeff-hykin added 14 commits October 18, 2026 23:18

gateway: fingerprint changed files by contents, since Linux mtimes ar…

e59c8e8

…e too coarse to see a quick edit

Merge remote-tracking branch 'origin/main' into HEAD

9e13b37

# Conflicts: # .github/workflows/ci.yml # dimos.yaml

gateway: narrow silent excepts, explain the two TODOs, trim annotatio…

252cc5c

…ns prose, drop a blueprint main deleted

Merge commit '252cc5cdb2a370977934489ec3251e2909997faf' into HEAD

c546c00

Merge commit 'c546c006eeb241422c2de39cbe9018e31c581fee' into HEAD

ea66db4

blueprint_view: keep its React JSX settings in its own deno.json, not…

189e189

… the whole web workspace

blueprint_view: TODO for the relay_process private helpers

4199e85

gateway: API 5.0: /catalog (one blueprint shape, ?fields=, single-blu…

f68f5b6

…eprint rescan, modules, skills, robots, msgs), /config, and /runs (module, skill, exec, live skills, logs)

Merge commit 'f68f5b623ac409ba6cb4228d6dd78d4af1ca955c' into HEAD

3b718e1

# Conflicts: # dimos.yaml # experimental/gateway/README.md # experimental/gateway/app.py

Merge commit '3b718e12b3ddf9e126c01f75ce97b08f1beb7681' into HEAD

da67d39

# Conflicts: # experimental/gateway/app.py

blueprint_view: read and save config, the catalog and logs through th…

9d4bdbb

…e 5.0 routes

gateway: a blueprint's config schema says what the blueprint itself s…

f3fb509

…ets for each module field (value)

Merge commit 'f3fb5097b6567c399aa0d2c1cb99a48417b265da' into HEAD

bbfd1be

Merge commit 'bbfd1be2e8826eb1cce3ca63cd8a018710eea99a' into HEAD

2015d7b

jeff-hykin added 9 commits November 8, 2026 15:21

Revert the preview work: this PR is only the upload hang

3d815a7

The console-preview fixes (h264 cameras, opening an .mcap at all) landed here by accident of where they were written. They are not about the cloud endpoints and they do not belong in this PR; they continue on their own branch.

gateway: the account deadline also catches python 3.10's asyncio.Time…

a33b586

…outError

Merge remote-tracking branch 'origin/jeff/feat/gateway_cloud' into je…

f5c6733

…ff/feat/blueprint_view # Conflicts: # experimental/gateway/constants.py

gateway: msgs.js and the blueprint view build without deadlines, and …

688866b

…a missing schema shows lcm_codec's own error

gateway: a stats event per dtop sample and a log event when a run's l…

73c55f6

…og or the launch output grows

gateway: the blueprint view's remaining timers are config.yaml settin…

cda184d

…gs (blueprint-view:), served in GET /config

gateway: GET /cloud/account?loginNot= answers when the login moves on…

7530dc9

…, so the login page waits instead of polling

blueprint view: refresh on the gateway's events, one request in fligh…

5a3850f

…t, timers only from config

gateway: a module's config lists even when its blueprint() needs argu…

6c9e3ef

…ments (CollectionModule's input_types answered 500)

github-advanced-security Bot found potential problems Nov 10, 2026

View reviewed changes

Comment thread experimental/gateway/routes/web.py Fixed

gateway: blueprint view files and run ids checked without regexes (Co…

35dcc49

…deQL polynomial-regex alert)

greptile-apps Bot reviewed Nov 10, 2026

View reviewed changes

jeff-hykin added 8 commits November 10, 2026 09:25

gateway: API 8.5.0, with the stats and log events, GET /config's blue…

4c47a39

…printView and ?loginNot= in dimos.yaml and the docs

gateway: is_secret_name lives in introspect.py, so a checkout older t…

2f26c13

…han launches.py's dimos imports can still list blueprint configs (DIM-630: every /config was a 500)

wheels: the blueprint view's built dist and web/sdk's lcm.ts decoder …

5bed4f2

…ship, so a pip-installed gateway serves /blueprint_view and /msgs.js

blueprint view: the settings dialog shows and edits a blueprint's own…

ad9a5cb

… global overrides (they win at launch) instead of the shared value under them, and a module field saved as null shows null, not its default

blueprint view: a run started in a terminal gets the live run's logs,…

d32bf84

… process stats and Stop

gateway: GET /source?blueprint= reads the file from the checkout that…

a361241

… blueprint's live run came from, as the catalog reads its modules (Show code from a branch run)

gateway: a run's logs say watched: false when they're outside the log…

f95d010

…s/ folders the gateway watches (a third checkout), and the logs dialog polls those instead of waiting on log events; API 8.6.0

greptile-apps Bot reviewed Nov 10, 2026

View reviewed changes

paul-nechifor reviewed Nov 10, 2026

View reviewed changes

jeff-hykin added 3 commits November 10, 2026 22:01

gateway: a run's RPCs are called by name even when the gateway's own …

1cb287f

…copy of the module class lacks them (an RPC added in the run's checkout), and restart/stop no longer import the class; API 9.0.1

gateway: undo 9.0.1's calling RPCs the gateway's own module class lac…

4ead0fb

…ks (Desktop now runs the run's checkout's own gateway instead); API 9.0.2

Conversation

jeff-hykin commented Oct 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

go2 replay realtime (arm64)

Uh oh!

codecov Bot commented Oct 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ JUnit XML file not found

Uh oh!

Uh oh!

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

Uh oh!

Confidence Score: 3/5

Findings

Summary

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mustafab0 commented Nov 10, 2026

Uh oh!

greptile-apps Bot Nov 10, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 10, 2026

Choose a reason for hiding this comment

Uh oh!

paul-nechifor Nov 10, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 10, 2026

Choose a reason for hiding this comment

Uh oh!

paul-nechifor Nov 10, 2026

Choose a reason for hiding this comment

Uh oh!

paul-nechifor Nov 10, 2026

Choose a reason for hiding this comment

Uh oh!

paul-nechifor Nov 10, 2026

Choose a reason for hiding this comment

Uh oh!

paul-nechifor Nov 10, 2026

Choose a reason for hiding this comment

Uh oh!

This branch was successfully deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

jeff-hykin commented Oct 10, 2026 •

edited

Loading

github-actions Bot left a comment •

edited

Loading

codecov Bot commented Oct 10, 2026 •

edited

Loading

greptile-apps Bot commented Nov 10, 2026 •

edited

Loading