fix: add Windows path support in toImportSpecifier + add tests (#575)

[jlin53882]

Summary

Fix toImportSpecifier() to handle Windows drive-letter paths (C:\... / D:/...) by converting them to file:// URLs, and add the Windows APPDATA fallback from the closed PR #576.

Why This PR Exists (vs. the Closed PR #576)

PR #576 was closed because the initial implementation had a critical bug: it used toImportSpecifier(windowsNpmPath) which does NOT convert Windows paths to file:// URLs — they were passed unchanged to import(), causing ERR_UNSUPPORTED_ESM_URL_SCHEME.

This PR supersedes #576 with the correct fix: modifying toImportSpecifier() itself to detect Windows drive-letter paths and convert them via pathToFileURL().

Problem (Issue #575)

toImportSpecifier() only converted POSIX absolute paths (/ prefix) to file:// URLs. Windows paths like C:\Users\...\extensionAPI.js fell through to return trimmed and were passed unchanged to import(), causing the error:

ERR_UNSUPPORTED_ESM_URL_SCHEME

This affected both the Windows APPDATA fallback and any user who set OPENCLAW_EXTENSION_API_PATH to a Windows path.

Solution

Modify toImportSpecifier() to detect Windows drive-letter paths:

function toImportSpecifier(value: string): string {
  const trimmed = value.trim();
  if (!trimmed) return "";
  if (trimmed.startsWith("file://")) return trimmed;
  if (trimmed.startsWith("/")) return pathToFileURL(trimmed).href;
+ // Handle Windows absolute paths (e.g. C:\Users\... or D:/Program Files/...)
+ if (/^[a-zA-Z]:[/\\]/.test(trimmed)) return pathToFileURL(trimmed).href;
  return trimmed;
}

Also includes the APPDATA fallback from PR #576 (cherry-picked):

+  if (process.platform === "win32" && process.env.APPDATA) {
+    const windowsNpmPath = join(process.env.APPDATA, "npm", "node_modules", "openclaw", "dist", "extensionAPI.js");
+    specifiers.push(toImportSpecifier(windowsNpmPath));
+  }

Why This Approach (vs. Alternative Fixes)

Three rounds of adversarial Codex review concluded that fixing toImportSpecifier() itself is the cleanest solution because:

1. Covers all callers: OPENCLAW_EXTENSION_API_PATH env var (hidden issue /lesson命令是自己添加吗 没成功 #1) is also fixed
2. Minimal scope: Only +2 lines to toImportSpecifier(), the rest is the unchanged cherry-pick
3. Low risk: The regex check is additive and doesn't change any existing behavior

Tests

27 new tests covering:

• POSIX paths → file:// URL
• Windows paths (C:\, D:/) → file:// URL
• Pass-through cases (file://, bare module specifiers, relative paths)
• Edge cases (trailing slash, lowercase drive, DOS 8.3, UNC paths)
• getExtensionApiImportSpecifiers() behavior
• APPDATA fallback on win32

Codex Review History

Round	Production Fix	Tests	Verdict
Round 1	Incomplete (original PR #576)	0	NEEDS_CHANGES
Round 2	Correct (pathToFileURL().href)	0	NEEDS_CHANGES (tests)
Round 3	Correct	27/27 passing	APPROVED

Fixes #575

[jlin53882]

Reviewers

This PR supersedes the closed PR #576. The original PR had a bug where toImportSpecifier() didn't convert Windows paths — this version fixes toImportSpecifier() itself with a regex check for drive-letter paths.

Three rounds of adversarial Codex review. All 27 tests pass. 430/433 existing tests pass (3 pre-existing failures unrelated to this change).

cc: @rwmjhb @chatgpt-codex-connector[bot] — your earlier feedback shaped this fix, thank you.

[chatgpt-codex-connector]

To use Codex here, create an environment for this repo.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a799d65c10

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Normalize UNC absolute paths before dynamic import

The new Windows conversion only matches drive-letter paths (^[a-zA-Z]:[/\\]), so UNC absolute paths like \\server\share\... are still returned unchanged. This matters because the new APPDATA fallback can point to UNC locations in redirected-profile environments; in that case getExtensionApiImportSpecifiers() adds a raw UNC specifier and import(specifier) fails instead of loading extensionAPI.js. Please extend toImportSpecifier to treat UNC roots as filesystem paths and convert them with pathToFileURL() too.

Useful? React with 👍 / 👎.