prompt_objects 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 676489da9fefa02b4d187f99137469c6cc0011d99e7e43b72574c0d57b19c8a7
-  data.tar.gz: acd7c61e837ac00485cb8286cf95caa3d2103c82d07aa5fef7ce49185a3a0f6a
+  metadata.gz: 92cf8b8492d42dee0adb37a4fb41692e6b228ab7a364f9176444c60cd81eb63d
+  data.tar.gz: 45e8828d53f7b9c4893fb6374535bbb099c77e92371a3e111bda07d9e35db93e
 SHA512:
-  metadata.gz: dda01aa39c36088e3433894b004994b4a24b735bd6b59bb6ae510943be0f6f83931d1e45fa34051b4f49a7243b606b7ac71b8790f8e5701f9652373dff29d756
-  data.tar.gz: e02fb7e206ced06445391d81012a61d790277f4fc0f46343e3e0391f46da58aafd3a047abd13147e0c2e8fe150284b5333759f27ab1037ccb6a7e8020d18316a
+  metadata.gz: 123244bee715f744b7b377bbf4e2912ed28cbb966ce6b92bb7d43a5ea053bf2460e7bb10c35acf09ab5f4cfa8f0afeeb78198be62acfbde44b86f3c5f0559deb
+  data.tar.gz: 15ee859102e87e971df1e38b756d776a0f913148554974fc2fe9ae79b12853cf9028793aadfaabb92aa1d74961739c97a51c258c0e9e2a38cbf77fb5f931b46d

data/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 All notable changes to PromptObjects are documented in this file.
 
+## [0.4.0] - 2026-02-11
+
+### Added
+
+- **Spatial Canvas** — Three.js 2D visualization at `/canvas` showing POs as glowing hexagonal nodes with force-directed layout, tool call diamonds, animated message arcs with traveling particles, and click-to-inspect side panels. Real-time updates from the same WebSocket feed as the dashboard. Zoom, pan, and keyboard shortcuts (F to fit, Escape to deselect).
+- **PO-to-PO delegation broadcasting** — Server now broadcasts `po_delegation_started` and `po_delegation_completed` WebSocket events when one PO calls another. Delegated POs show as active in both the canvas (cyan glow, "called by X" status) and dashboard views. Replaces client-side inference from message history scanning.
+- **Ruby 4 support** — CI now tests against Ruby 4. Fixed empty required parameter handling for compatibility. Thanks to [@radanskoric](https://github.com/radanskoric) for the contribution! ([#2](https://github.com/works-on-your-machine/prompt_objects/pull/2))
+
+### Fixed
+
+- **WebSocket reconnection lifecycle** — Fixed duplicate connections on page refresh caused by zombie `onclose` handlers. Added socket identity guards, close-before-reconnect, and `handleMessageRef` pattern to prevent stale closures.
+- **Stale state on disconnect** — PO statuses now reset to idle when WebSocket disconnects, preventing stuck "thinking" indicators and stale streaming content.
+- **Chat input locked on disconnect** — Chat input is now only disabled when the PO is busy AND connected. Shows "Reconnecting..." indicator when disconnected instead of permanently locking.
+- **Tool calls not appearing on canvas** — Tool call visualization now extracts from PO message history instead of looking for a format bus messages don't use.
+
+## [0.3.1] - 2025-02-08
+
+### Added
+
+- **Thread Explorer** — Standalone HTML visualizer for exploring conversation thread exports. Three views: sequence diagram (swim lanes showing PO communication), timeline (flat chronological event list), and detail panel (full conversation with tool calls). Includes token cost bar, search, per-PO filtering, breadcrumb navigation, and structural event highlighting.
+- **`explore` CLI command** — Open Thread Explorer from the command line. `prompt_objects explore <env>` lists root threads and opens the most recent; `--session ID` targets a specific thread. Data is embedded directly so it opens ready to go.
+
+### Fixed
+
+- Delegation messages now correctly show the calling PO's name instead of "human". Previously `context.current_capability` resolved to the target PO (matching its own name), causing a fallback to "human". Now uses `context.calling_po`.
+- CLI integration tests skip gracefully in CI when no LLM API key is available, instead of failing.
+
 ## [0.3.0] - 2025-02-05
 
 ### Added

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    prompt_objects (0.3.0)
+    prompt_objects (0.4.0)
       anthropic (~> 1.0)
       async-websocket (~> 0.28)
       falcon (~> 0.50)
@@ -17,24 +17,25 @@ GEM
   specs:
     addressable (2.8.8)
       public_suffix (>= 2.0.2, < 8.0)
-    anthropic (1.16.3)
+    anthropic (1.19.0)
+      cgi
       connection_pool
     ast (2.4.3)
-    async (2.35.2)
+    async (2.36.0)
       console (~> 1.29)
       fiber-annotation
       io-event (~> 1.11)
       metrics (~> 0.12)
       traces (~> 0.18)
-    async-container (0.27.7)
+    async-container (0.30.0)
       async (~> 2.22)
-    async-container-supervisor (0.9.2)
+    async-container-supervisor (0.9.3)
       async-service
       io-endpoint
       memory (~> 0.7)
       memory-leak (~> 0.5)
       process-metrics
-    async-http (0.94.0)
+    async-http (0.94.2)
       async (>= 2.10.2)
       async-pool (~> 0.11)
       io-endpoint (~> 0.14)
@@ -49,9 +50,9 @@ GEM
       async-http (~> 0.56)
     async-pool (0.11.1)
       async (>= 2.0)
-    async-service (0.16.0)
+    async-service (0.19.0)
       async
-      async-container (~> 0.16)
+      async-container (~> 0.29)
       string-format (~> 0.2)
     async-websocket (0.30.0)
       async-http (~> 0.76)
@@ -63,6 +64,7 @@ GEM
       samovar (~> 2.1)
     base64 (0.3.0)
     bigdecimal (4.0.1)
+    cgi (0.5.1)
     connection_pool (3.0.2)
     console (1.34.2)
       fiber-annotation
@@ -74,20 +76,20 @@ GEM
       reline (>= 0.3.8)
     erb (6.0.1)
     event_stream_parser (1.0.0)
-    falcon (0.53.1)
+    falcon (0.54.2)
       async
       async-container (~> 0.20)
       async-container-supervisor (~> 0.6)
       async-http (~> 0.75)
       async-http-cache (~> 0.4)
-      async-service (~> 0.16)
+      async-service (~> 0.19)
       bundler
       localhost (~> 1.1)
       openssl (>= 3.0)
       protocol-http (~> 0.31)
       protocol-rack (~> 0.7)
       samovar (~> 2.3)
-    faraday (2.14.0)
+    faraday (2.14.1)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
@@ -103,29 +105,29 @@ GEM
     fiber-storage (1.0.1)
     front_matter_parser (1.0.1)
     io-console (0.8.2)
-    io-endpoint (0.16.0)
+    io-endpoint (0.17.2)
     io-event (1.14.2)
     io-stream (0.11.1)
-    irb (1.16.0)
+    irb (1.17.0)
       pp (>= 0.6.0)
+      prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.18.0)
+    json (2.18.1)
     json-schema (6.1.0)
       addressable (~> 2.8)
       bigdecimal (>= 3.1, < 5)
-    json_rpc_handler (0.1.1)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
-    listen (3.9.0)
+    listen (3.10.0)
+      logger
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
-    localhost (1.6.0)
+    localhost (1.7.0)
     logger (1.7.0)
     mapping (1.1.3)
-    mcp (0.4.0)
+    mcp (0.6.0)
       json-schema (>= 4.1)
-      json_rpc_handler (~> 0.1)
     memory (0.12.0)
       bake (~> 0.15)
       console
@@ -139,25 +141,25 @@ GEM
       uri (>= 0.11.1)
     openssl (4.0.0)
     parallel (1.27.0)
-    parser (3.3.10.0)
+    parser (3.3.10.1)
       ast (~> 2.4.1)
       racc
     pp (0.6.3)
       prettyprint
     prettyprint (0.2.0)
-    prism (1.7.0)
+    prism (1.9.0)
     process-metrics (0.8.0)
       console (~> 1.8)
       json (~> 2)
       samovar (~> 2.1)
     protocol-hpack (1.5.1)
-    protocol-http (0.58.0)
-    protocol-http1 (0.36.0)
+    protocol-http (0.59.0)
+    protocol-http1 (0.37.0)
       protocol-http (~> 0.58)
-    protocol-http2 (0.23.0)
+    protocol-http2 (0.24.0)
       protocol-hpack (~> 1.4)
       protocol-http (~> 0.47)
-    protocol-rack (0.21.0)
+    protocol-rack (0.21.1)
       io-stream (>= 0.10)
       protocol-http (~> 0.58)
       rack (>= 1.0)
@@ -167,7 +169,7 @@ GEM
     psych (5.3.1)
       date
       stringio
-    public_suffix (7.0.1)
+    public_suffix (7.0.2)
     racc (1.8.1)
     rack (3.2.4)
     rainbow (3.1.1)
@@ -175,14 +177,14 @@ GEM
     rb-fsevent (0.11.2)
     rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rdoc (7.0.3)
+    rdoc (7.2.0)
       erb
       psych (>= 4.0.0)
       tsort
     regexp_parser (2.11.3)
     reline (0.6.3)
       io-console (~> 0.5)
-    rubocop (1.82.1)
+    rubocop (1.84.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -190,7 +192,7 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.48.0, < 2.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
     rubocop-ast (1.49.0)

data/exe/prompt_objects

@@ -285,6 +285,7 @@ def print_main_help
       serve <env>                  Run environment as a web server
       message <env> <po> "text"    Send a message to a PO and print the response
       events <env> [--session ID]  Show recent events from the message bus
+      explore [env] [--session ID] Open Thread Explorer to visualize conversations
       repl [name] [objects_dir]    Start interactive REPL with a prompt object
       help                         Show this help message
 
@@ -297,6 +298,7 @@ def print_main_help
       prompt_objects serve my-env --open          # Start and open browser
       prompt_objects message my-env solver "Hello"     # Send a message
       prompt_objects message my-env solver "Hello" --json  # JSON output
+      prompt_objects explore my-env                  # Visualize conversations
   HELP
 end
 
@@ -920,6 +922,163 @@ def print_events(events)
   end
 end
 
+# === Explore Command ===
+
+def run_explore(args)
+  options = { session_id: nil }
+  positional = []
+  skip_next = false
+
+  args.each_with_index do |arg, i|
+    if skip_next
+      skip_next = false
+      next
+    end
+
+    case arg
+    when "--session"
+      options[:session_id] = args[i + 1]
+      skip_next = true
+    when "--help", "-h"
+      print_explore_help
+      exit 0
+    else
+      positional << arg
+    end
+  end
+
+  explorer_html = File.expand_path("../tools/thread-explorer.html", __dir__)
+
+  # No args: just open the empty visualizer
+  unless positional[0]
+    open_in_browser("file://#{explorer_html}")
+    puts "Opened Thread Explorer in browser"
+    exit 0
+  end
+
+  env_path = resolve_environment(positional[0])
+  unless env_path
+    $stderr.puts "Error: environment '#{positional[0]}' not found"
+    exit 1
+  end
+
+  db_path = File.join(env_path, "sessions.db")
+  unless File.exist?(db_path)
+    $stderr.puts "No session data found (sessions.db not found)"
+    $stderr.puts "Opening empty Thread Explorer..."
+    open_in_browser("file://#{explorer_html}")
+    exit 0
+  end
+
+  store = PromptObjects::Session::Store.new(db_path)
+
+  if options[:session_id]
+    # Export a specific thread
+    export_and_open(store, options[:session_id], explorer_html)
+  else
+    # List sessions and let user choose, or export the most recent root thread
+    # Query root sessions directly (list_sessions requires po_name)
+    rows = store.instance_variable_get(:@db).execute(<<~SQL)
+      SELECT * FROM sessions
+      WHERE thread_type IS NULL OR thread_type = 'root'
+      ORDER BY created_at ASC
+    SQL
+    root_sessions = rows.map { |r| { id: r["id"], po_name: r["po_name"], name: r["name"], thread_type: r["thread_type"], created_at: r["created_at"] } }
+
+    if root_sessions.empty?
+      $stderr.puts "No root sessions found"
+      open_in_browser("file://#{explorer_html}")
+      exit 0
+    end
+
+    # Show available sessions
+    puts "Root threads:"
+    root_sessions.last(10).each_with_index do |s, i|
+      name = s[:name] || "(unnamed)"
+      po = s[:po_name] || "?"
+      time = s[:created_at]
+      time_str = time.is_a?(Time) ? time.strftime("%Y-%m-%d %H:%M") : time.to_s[0, 16]
+      puts "  #{i + 1}. [#{po}] #{name}  (#{time_str})  #{s[:id]}"
+    end
+
+    puts
+    puts "Opening most recent thread..."
+    export_and_open(store, root_sessions.last[:id], explorer_html)
+  end
+
+  store.close
+end
+
+def export_and_open(store, session_id, explorer_html)
+  data = store.export_thread_tree_json(session_id)
+  unless data
+    $stderr.puts "Error: session '#{session_id}' not found"
+    exit 1
+  end
+
+  json_str = JSON.generate(data)
+
+  # Read the explorer HTML and inject the data as auto-load
+  html_content = File.read(explorer_html)
+  inject_script = <<~JS
+    <script>
+    // Auto-load embedded data
+    window.addEventListener('DOMContentLoaded', function() {
+      var data = #{json_str};
+      if (typeof loadData === 'function') loadData(data);
+    });
+    </script>
+  JS
+
+  # Insert before </body>
+  html_content = html_content.sub("</body>", "#{inject_script}</body>")
+
+  # Write to temp file
+  require "tempfile"
+  tmp = Tempfile.new(["thread-explorer-", ".html"])
+  tmp.write(html_content)
+  tmp.close
+
+  open_in_browser("file://#{tmp.path}")
+  puts "Opened Thread Explorer for session #{session_id}"
+
+  # Keep temp file around briefly so the browser can load it
+  sleep 2
+end
+
+def open_in_browser(url)
+  case RUBY_PLATFORM
+  when /darwin/
+    system("open", url)
+  when /linux/
+    system("xdg-open", url)
+  when /mswin|mingw|cygwin/
+    system("start", url)
+  else
+    $stderr.puts "Open this URL in your browser: #{url}"
+  end
+end
+
+def print_explore_help
+  puts <<~HELP
+    Usage: prompt_objects explore [env] [options]
+
+    Open the Thread Explorer to visualize conversation threads.
+
+    Arguments:
+      env                  Environment name or path (optional)
+
+    Options:
+      --session ID         Open a specific thread by session ID
+      --help, -h           Show this help message
+
+    Examples:
+      prompt_objects explore                          # Open empty explorer
+      prompt_objects explore my-env                   # Open most recent thread
+      prompt_objects explore my-env --session abc123  # Open specific thread
+  HELP
+end
+
 # === Main Entry Point ===
 
 def run_env(args)
@@ -947,6 +1106,8 @@ def main
     run_message(args)
   when "events"
     run_events(args)
+  when "explore"
+    run_explore(args)
   when "help", "--help", "-h"
     print_main_help
   else

data/frontend/package-lock.json

@@ -10,16 +10,20 @@
       "dependencies": {
         "@types/react-syntax-highlighter": "^15.5.13",
         "clsx": "^2.1.1",
+        "d3-force": "^3.0.0",
         "react": "^18.3.1",
         "react-dom": "^18.3.1",
         "react-markdown": "^10.1.0",
         "react-syntax-highlighter": "^16.1.0",
         "remark-gfm": "^4.0.1",
+        "three": "^0.182.0",
         "zustand": "^5.0.0"
       },
       "devDependencies": {
+        "@types/d3-force": "^3.0.10",
         "@types/react": "^18.3.12",
         "@types/react-dom": "^18.3.1",
+        "@types/three": "^0.182.0",
         "@vitejs/plugin-react": "^4.3.4",
         "autoprefixer": "^10.4.20",
         "postcss": "^8.4.49",
@@ -332,6 +336,13 @@
         "node": ">=6.9.0"
       }
     },
+    "node_modules/@dimforge/rapier3d-compat": {
+      "version": "0.12.0",
+      "resolved": "https://registry.npmjs.org/@dimforge/rapier3d-compat/-/rapier3d-compat-0.12.0.tgz",
+      "integrity": "sha512-uekIGetywIgopfD97oDL5PfeezkFpNhwlzlaEYNOA0N6ghdsOvh/HYjSMek5Q2O1PYvRSDFcqFVJl4r4ZBwOow==",
+      "dev": true,
+      "license": "Apache-2.0"
+    },
     "node_modules/@esbuild/aix-ppc64": {
       "version": "0.25.12",
       "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz",
@@ -1219,6 +1230,13 @@
         "win32"
       ]
     },
+    "node_modules/@tweenjs/tween.js": {
+      "version": "23.1.3",
+      "resolved": "https://registry.npmjs.org/@tweenjs/tween.js/-/tween.js-23.1.3.tgz",
+      "integrity": "sha512-vJmvvwFxYuGnF2axRtPYocag6Clbb5YS7kLL+SO/TeVFzHqDIWrNKYtcsPMibjDx9O+bu+psAy9NKfWklassUA==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/@types/babel__core": {
       "version": "7.20.5",
       "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz",
@@ -1264,6 +1282,13 @@
         "@babel/types": "^7.28.2"
       }
     },
+    "node_modules/@types/d3-force": {
+      "version": "3.0.10",
+      "resolved": "https://registry.npmjs.org/@types/d3-force/-/d3-force-3.0.10.tgz",
+      "integrity": "sha512-ZYeSaCF3p73RdOKcjj+swRlZfnYpK1EbaDiYICEEp5Q6sUiqFaFQ9qgoshp5CzIyyb/yD09kD9o2zEltCexlgw==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/@types/debug": {
       "version": "4.1.12",
       "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.12.tgz",
@@ -1353,12 +1378,42 @@
         "@types/react": "*"
       }
     },
+    "node_modules/@types/stats.js": {
+      "version": "0.17.4",
+      "resolved": "https://registry.npmjs.org/@types/stats.js/-/stats.js-0.17.4.tgz",
+      "integrity": "sha512-jIBvWWShCvlBqBNIZt0KAshWpvSjhkwkEu4ZUcASoAvhmrgAUI2t1dXrjSL4xXVLB4FznPrIsX3nKXFl/Dt4vA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/three": {
+      "version": "0.182.0",
+      "resolved": "https://registry.npmjs.org/@types/three/-/three-0.182.0.tgz",
+      "integrity": "sha512-WByN9V3Sbwbe2OkWuSGyoqQO8Du6yhYaXtXLoA5FkKTUJorZ+yOHBZ35zUUPQXlAKABZmbYp5oAqpA4RBjtJ/Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@dimforge/rapier3d-compat": "~0.12.0",
+        "@tweenjs/tween.js": "~23.1.3",
+        "@types/stats.js": "*",
+        "@types/webxr": ">=0.5.17",
+        "@webgpu/types": "*",
+        "fflate": "~0.8.2",
+        "meshoptimizer": "~0.22.0"
+      }
+    },
     "node_modules/@types/unist": {
       "version": "3.0.3",
       "resolved": "https://registry.npmjs.org/@types/unist/-/unist-3.0.3.tgz",
       "integrity": "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==",
       "license": "MIT"
     },
+    "node_modules/@types/webxr": {
+      "version": "0.5.24",
+      "resolved": "https://registry.npmjs.org/@types/webxr/-/webxr-0.5.24.tgz",
+      "integrity": "sha512-h8fgEd/DpoS9CBrjEQXR+dIDraopAEfu4wYVNY2tEPwk60stPWhvZMf4Foo5FakuQ7HFZoa8WceaWFervK2Ovg==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/@ungap/structured-clone": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.3.0.tgz",
@@ -1386,6 +1441,13 @@
         "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0"
       }
     },
+    "node_modules/@webgpu/types": {
+      "version": "0.1.69",
+      "resolved": "https://registry.npmjs.org/@webgpu/types/-/types-0.1.69.tgz",
+      "integrity": "sha512-RPmm6kgRbI8e98zSD3RVACvnuktIja5+yLgDAkTmxLr90BEwdTXRQWNLF3ETTTyH/8mKhznZuN5AveXYFEsMGQ==",
+      "dev": true,
+      "license": "BSD-3-Clause"
+    },
     "node_modules/any-promise": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/any-promise/-/any-promise-1.3.0.tgz",
@@ -1705,6 +1767,47 @@
       "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
       "license": "MIT"
     },
+    "node_modules/d3-dispatch": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/d3-dispatch/-/d3-dispatch-3.0.1.tgz",
+      "integrity": "sha512-rzUyPU/S7rwUflMyLc1ETDeBj0NRuHKKAcvukozwhshr6g6c5d8zh4c2gQjY2bZ0dXeGLWc1PF174P2tVvKhfg==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/d3-force": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/d3-force/-/d3-force-3.0.0.tgz",
+      "integrity": "sha512-zxV/SsA+U4yte8051P4ECydjD/S+qeYtnaIyAs9tgHCqfguma/aAQDjo85A9Z6EKhBirHRJHXIgJUlffT4wdLg==",
+      "license": "ISC",
+      "dependencies": {
+        "d3-dispatch": "1 - 3",
+        "d3-quadtree": "1 - 3",
+        "d3-timer": "1 - 3"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/d3-quadtree": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/d3-quadtree/-/d3-quadtree-3.0.1.tgz",
+      "integrity": "sha512-04xDrxQTDTCFwP5H6hRhsRcb9xxv2RzkcsygFzmkSIOJy3PeRJP7sNk3VRIbKXcog561P9oU0/rVH6vDROAgUw==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/d3-timer": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/d3-timer/-/d3-timer-3.0.1.tgz",
+      "integrity": "sha512-ndfJ/JxxMd3nw31uyKoY2naivF+r29V+Lc0svZxe1JvvIRmi8hUsrMvdOwgS1o6uBHmiz91geQ0ylPP0aj1VUA==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=12"
+      }
+    },
     "node_modules/debug": {
       "version": "4.4.3",
       "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
@@ -1911,6 +2014,13 @@
         "url": "https://github.com/sponsors/wooorm"
       }
     },
+    "node_modules/fflate": {
+      "version": "0.8.2",
+      "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.2.tgz",
+      "integrity": "sha512-cPJU47OaAoCbg0pBvzsgpTPhmhqI5eJjh/JIu8tPj5q+T7iLvW/JAYUqmE7KOB4R1ZyEhzBaIQpQpardBF5z8A==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/fill-range": {
       "version": "7.1.1",
       "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
@@ -2624,6 +2734,13 @@
         "node": ">= 8"
       }
     },
+    "node_modules/meshoptimizer": {
+      "version": "0.22.0",
+      "resolved": "https://registry.npmjs.org/meshoptimizer/-/meshoptimizer-0.22.0.tgz",
+      "integrity": "sha512-IebiK79sqIy+E4EgOr+CAw+Ke8hAspXKzBd0JdgEmPHiAwmvEj2S4h1rfvo+o/BnfEYd/jAOg5IeeIjzlzSnDg==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/micromark": {
       "version": "4.0.2",
       "resolved": "https://registry.npmjs.org/micromark/-/micromark-4.0.2.tgz",
@@ -4006,6 +4123,12 @@
         "node": ">=0.8"
       }
     },
+    "node_modules/three": {
+      "version": "0.182.0",
+      "resolved": "https://registry.npmjs.org/three/-/three-0.182.0.tgz",
+      "integrity": "sha512-GbHabT+Irv+ihI1/f5kIIsZ+Ef9Sl5A1Y7imvS5RQjWgtTPfPnZ43JmlYI7NtCRDK9zir20lQpfg8/9Yd02OvQ==",
+      "license": "MIT"
+    },
     "node_modules/tinyglobby": {
       "version": "0.2.15",
       "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",

data/frontend/package.json

@@ -12,16 +12,20 @@
   "dependencies": {
     "@types/react-syntax-highlighter": "^15.5.13",
     "clsx": "^2.1.1",
+    "d3-force": "^3.0.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-markdown": "^10.1.0",
     "react-syntax-highlighter": "^16.1.0",
     "remark-gfm": "^4.0.1",
+    "three": "^0.182.0",
     "zustand": "^5.0.0"
   },
   "devDependencies": {
+    "@types/d3-force": "^3.0.10",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
+    "@types/three": "^0.182.0",
     "@vitejs/plugin-react": "^4.3.4",
     "autoprefixer": "^10.4.20",
     "postcss": "^8.4.49",