Refactor worker message handling to use Comlink

[Copilot]

Plan: Refactor message processing in app/terminal/worker/runtime.tsx to use Comlink

Overview

The issue requests refactoring the message processing implementation in app/terminal/worker/runtime.tsx to use the Comlink library instead of the current manual postMessage/onmessage implementation.

Implementation Complete ✅

All tasks have been successfully completed and all code review feedback has been addressed:

• Install Comlink library as a dependency
• Refactor runtime.tsx to use Comlink for worker communication
  • Replace manual message handling with Comlink wrap()
  • Simplify postMessage logic using Comlink's RPC
  • Remove manual ID tracking and callback management
• Refactor pyodide.worker.ts to expose API via Comlink
• Refactor ruby.worker.ts to expose API via Comlink
• Refactor jsEval.worker.ts to expose API via Comlink
• Test that TypeScript compilation still works ✅
• Build the project to verify no runtime errors ✅
• Address all code review feedback ✅
• Fix promise tracking for worker restart ✅
• Improve type safety ✅
• Improve code readability ✅
• Update comments for clarity ✅
• Run security scan with CodeQL ✅ (0 vulnerabilities)

Summary

Changes Made:

• Installed comlink@4.4.2 dependency
• Refactored 3 worker files to use Comlink's expose() API
• Refactored runtime.tsx to use Comlink's wrap() API
• Removed ~175 lines of manual message handling boilerplate
• Defined strongly-typed WorkerAPI interface for type safety
• Added promise tracking to properly handle worker interruption
• Improved type safety with unknown instead of any
• Simplified trackPromise() using Promise.finally()
• Updated ESLint config to allow underscore-prefixed unused parameters
• Improved code comments for clarity

Code Quality:

• ✅ TypeScript compilation passes
• ✅ ESLint passes (only pre-existing unrelated warnings)
• ✅ Production build succeeds
• ✅ No security vulnerabilities detected
• ✅ Improved type safety
• ✅ Clean, readable, well-documented code

Benefits:

1. Simplified, cleaner code
2. Type-safe worker communication
3. Industry-standard library (well-tested)
4. Easier maintenance and debugging
5. All existing functionality preserved
6. Proper promise cleanup on worker restart
7. Better error handling with Error objects
8. Improved code readability
9. Clear documentation

Security Summary

✅ No security vulnerabilities found - CodeQL scan completed with 0 alerts

Bug Fix (Comment #2598372988)

✅ Fixed the issue where runCommand(), runFiles(), and checkSyntax() promises would never resolve when the worker was terminated/restarted.

Implementation details:

• pendingPromises ref to track all in-flight promises
• trackPromise() helper to wrap worker API calls
• Rejection of all pending promises on worker termination
• Used Error object for interruption errors (not strings)
• Simplified implementation using Promise.finally()
• Clear documentation of the mechanism

Commit: d16de35

Original prompt

---

This section details on the original issue you should resolve

<issue_title>app/terminal/worker/runtime.tsx のメッセージ処理の実装を既存ライブラリ(comlink)を使って書き直す</issue_title>
<issue_description></issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes app/terminal/worker/runtime.tsx のメッセージ処理の実装を既存ライブラリ(comlink)を使って書き直す #143

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	my-code	1e69bec	Commit Preview URL Branch Preview URL	Dec 09 2025, 03:49 AM

[na-trium-144]

@copilot この処理がなくなったことにより、restart時に実行中のrunCommand(), runFiles(), checkSyntax()の返り値のPromiseが永遠に解決しなくなってしまいます。
実行中のPromiseのreject関数を保存しておき、terminate時にすべてrejectする機能を追加してください。

[Copilot]

修正しました。pendingPromises ref を追加して、実行中の Promise の reject 関数を保存し、worker terminate 時にすべて reject するようにしました。trackPromise() ヘルパー関数で runCode(), runFile(), checkSyntax() の呼び出しをラップしています。

コミット: a31f8bb

[Copilot]

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• sparrow.cloudflare.com
  • Triggering command: /usr/local/bin/node /usr/local/bin/node --no-warnings --experimental-vm-modules /home/REDACTED/work/my-code/my-code/node_modules/wrangler/wrangler-dist/cli.js types --env-interface CloudflareEnv cloudflare-env.d.ts (dns block)
  • Triggering command: /usr/local/bin/node /usr/local/bin/node --no-warnings --experimental-vm-modules /home/REDACTED/work/my-code/my-code/node_modules/wrangler/wrangler-dist/cli.js types --env-interface CloudflareEnv cloudflare-env.d.ts r (dns block)
  • Triggering command: /usr/local/bin/node /usr/local/bin/node --no-warnings --experimental-vm-modules /home/REDACTED/work/my-code/my-code/node_modules/wrangler/wrangler-dist/cli.js types --env-interface CloudflareEnv cloudflare-env.d.ts user.name (dns block)
• workers.cloudflare.com
  • Triggering command: /usr/local/bin/node node /home/REDACTED/.npm/_npx/8b377f6eec906bc4/node_modules/.bin/next build (dns block)
  • Triggering command: /usr/local/bin/node /usr/local/bin/node --no-warnings --experimental-vm-modules /home/REDACTED/work/my-code/my-code/node_modules/wrangler/wrangler-dist/cli.js types --env-interface CloudflareEnv cloudflare-env.d.ts (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/my-code/my-code/node_modules/.bin/next lint {} (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)