codex-overleaf-link 1.8.3 → 1.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  <h1>Codex Overleaf Link</h1>
4
4
  <p><strong>Empower Overleaf with Codex.</strong></p>
5
5
  <p>
6
- <img src="https://img.shields.io/badge/version-1.8.3-blue" alt="version">
6
+ <img src="https://img.shields.io/badge/version-1.8.4-blue" alt="version">
7
7
  <img src="https://img.shields.io/badge/platform-macOS%20%2F%20Windows%20%2F%20Linux-lightgrey" alt="platform">
8
8
  <img src="https://img.shields.io/badge/chrome-MV3-green" alt="chrome manifest v3">
9
9
  <img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" alt="node version">
@@ -38,14 +38,14 @@ One command installs the native host **and** sets up the extension: the script r
38
38
  macOS / Linux:
39
39
 
40
40
  ```bash
41
- CODEX_OVERLEAF_REF=v1.8.3 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.8.3/install.sh)"
41
+ CODEX_OVERLEAF_REF=v1.8.4 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.8.4/install.sh)"
42
42
  ```
43
43
 
44
44
  Windows PowerShell:
45
45
 
46
46
  ```powershell
47
- iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.8.3/install.ps1 -OutFile install.ps1
48
- $env:CODEX_OVERLEAF_REF='v1.8.3'
47
+ iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.8.4/install.ps1 -OutFile install.ps1
48
+ $env:CODEX_OVERLEAF_REF='v1.8.4'
49
49
  powershell -ExecutionPolicy Bypass -File install.ps1
50
50
  ```
51
51
 
@@ -56,10 +56,10 @@ Then, in the `chrome://extensions` tab the script opened: enable **Developer mod
56
56
  `npm exec` installs and updates the **native host only** — it does not include the Chrome extension. Use it if you prefer a pinned npm package to a source checkout.
57
57
 
58
58
  ```bash
59
- npm exec --yes codex-overleaf-link@1.8.3 -- install-native
59
+ npm exec --yes codex-overleaf-link@1.8.4 -- install-native
60
60
  ```
61
61
 
62
- Then add the extension yourself: download `codex-overleaf-link-extension-v1.8.3.zip` from the [v1.8.3 GitHub Release](https://github.com/Ghqqqq/codex-overleaf-link/releases/tag/v1.8.3), unzip it to a stable folder, and in `chrome://extensions` enable **Developer mode**, click **Load unpacked**, and select that folder.
62
+ Then add the extension yourself: download `codex-overleaf-link-extension-v1.8.4.zip` from the [v1.8.4 GitHub Release](https://github.com/Ghqqqq/codex-overleaf-link/releases/tag/v1.8.4), unzip it to a stable folder, and in `chrome://extensions` enable **Developer mode**, click **Load unpacked**, and select that folder.
63
63
 
64
64
  ### Open Overleaf
65
65
 
@@ -86,9 +86,9 @@ npm installs, updates, uninstalls, and diagnoses the native host only. npm does
86
86
 
87
87
  | Action | Command |
88
88
  |--------|---------|
89
- | Install / update | `npm exec --yes codex-overleaf-link@1.8.3 -- install-native` |
90
- | Diagnose | `npm exec --yes codex-overleaf-link@1.8.3 -- doctor` |
91
- | Uninstall | `npm exec --yes codex-overleaf-link@1.8.3 -- uninstall-native` |
89
+ | Install / update | `npm exec --yes codex-overleaf-link@1.8.4 -- install-native` |
90
+ | Diagnose | `npm exec --yes codex-overleaf-link@1.8.4 -- doctor` |
91
+ | Uninstall | `npm exec --yes codex-overleaf-link@1.8.4 -- uninstall-native` |
92
92
 
93
93
  Use `--extension-id <chrome-extension-id>` only for a custom/dev unpacked extension id that differs from the official bundled id.
94
94
 
@@ -98,13 +98,13 @@ To update, re-run any of the [native host installers](#install) — they install
98
98
 
99
99
  ## GitHub Release Artifacts
100
100
 
101
- The v1.8.3 GitHub Release contains:
101
+ The v1.8.4 GitHub Release contains:
102
102
 
103
- - `codex-overleaf-link-extension-v1.8.3.zip`: loadable Chrome extension package for manual unpacked installation.
104
- - `codex-overleaf-native-host-v1.8.3.tar.gz`: native host runtime files used by the installer and release verification.
105
- - `codex-overleaf-link-1.8.3.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
106
- - `install.sh`: release-pinned macOS / Linux installer that defaults to `v1.8.3` when run directly from the release artifact.
107
- - `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.8.3` when run directly from the release artifact.
103
+ - `codex-overleaf-link-extension-v1.8.4.zip`: loadable Chrome extension package for manual unpacked installation.
104
+ - `codex-overleaf-native-host-v1.8.4.tar.gz`: native host runtime files used by the installer and release verification.
105
+ - `codex-overleaf-link-1.8.4.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
106
+ - `install.sh`: release-pinned macOS / Linux installer that defaults to `v1.8.4` when run directly from the release artifact.
107
+ - `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.8.4` when run directly from the release artifact.
108
108
  - `uninstall-native-host.mjs`: native host uninstaller that removes the Chrome Native Messaging manifest, bridge executable, and runtime copy.
109
109
  - `nativeHostPlatform.js`, `manifest.js`, `runtimeInstaller.js`: helper files required by the loose uninstaller asset.
110
110
  - `SHA256SUMS` and `release-manifest.json`: checksum and artifact metadata for release verification.
@@ -115,7 +115,7 @@ The v1.8.3 GitHub Release contains:
115
115
  Remove the native host (use `--browser chromium` on Linux Chromium):
116
116
 
117
117
  ```bash
118
- npm exec --yes codex-overleaf-link@1.8.3 -- uninstall-native
118
+ npm exec --yes codex-overleaf-link@1.8.4 -- uninstall-native
119
119
  ```
120
120
 
121
121
  The same command works on Windows PowerShell. If you installed from a manual checkout or source installer, you can also run `npm run uninstall:native` inside the repo, use `node ~/.codex-overleaf/source/scripts/uninstall-native-host.mjs` on macOS / Linux, or use `node $env:LOCALAPPDATA\CodexOverleaf\source\scripts\uninstall-native-host.mjs` on Windows PowerShell.
@@ -150,13 +150,13 @@ Then remove the extension from `chrome://extensions`. To delete local data: on m
150
150
  Linux Chromium install or update:
151
151
 
152
152
  ```bash
153
- CODEX_OVERLEAF_REF=v1.8.3 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.8.3/install.sh)" -- --browser chromium
153
+ CODEX_OVERLEAF_REF=v1.8.4 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.8.4/install.sh)" -- --browser chromium
154
154
  ```
155
155
 
156
156
  Linux Chromium uninstall:
157
157
 
158
158
  ```bash
159
- npm exec --yes codex-overleaf-link@1.8.3 -- uninstall-native --browser chromium
159
+ npm exec --yes codex-overleaf-link@1.8.4 -- uninstall-native --browser chromium
160
160
  ```
161
161
 
162
162
  ## Features
@@ -291,7 +291,7 @@ Composer attachments are turn-scoped Codex context. Limits are 8 attachments per
291
291
  Re-run any [native host installer](#install), reload the extension in `chrome://extensions`, then refresh the Overleaf tab. This also fixes extension/native version mismatch and native protocol mismatch.
292
292
 
293
293
  ```bash
294
- npm exec --yes codex-overleaf-link@1.8.3 -- install-native
294
+ npm exec --yes codex-overleaf-link@1.8.4 -- install-native
295
295
  ```
296
296
 
297
297
  **The Windows popup or panel shows a Bash recovery command**
@@ -340,8 +340,8 @@ Use this matrix for release-candidate signoff and compatibility reports. Record
340
340
  | Browser/channel/version | Google Chrome channel and version. | Google Chrome channel and version. | Google Chrome channel and version. | Chromium channel/package and version. |
341
341
  | Install mode | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout; native host installed with `--browser chromium`. |
342
342
  | Extension id | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. |
343
- | Installer/update command | `npm exec --yes codex-overleaf-link@1.8.3 -- install-native` | `npm exec --yes codex-overleaf-link@1.8.3 -- install-native` | `npm exec --yes codex-overleaf-link@1.8.3 -- install-native` | `npm exec --yes codex-overleaf-link@1.8.3 -- install-native --browser chromium` |
344
- | Uninstall command | `npm exec --yes codex-overleaf-link@1.8.3 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.8.3 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.8.3 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.8.3 -- uninstall-native --browser chromium` |
343
+ | Installer/update command | `npm exec --yes codex-overleaf-link@1.8.4 -- install-native` | `npm exec --yes codex-overleaf-link@1.8.4 -- install-native` | `npm exec --yes codex-overleaf-link@1.8.4 -- install-native` | `npm exec --yes codex-overleaf-link@1.8.4 -- install-native --browser chromium` |
344
+ | Uninstall command | `npm exec --yes codex-overleaf-link@1.8.4 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.8.4 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.8.4 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.8.4 -- uninstall-native --browser chromium` |
345
345
  | Manifest/registry path | `~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.codex.overleaf.json` | `HKCU\Software\Google\Chrome\NativeMessagingHosts\com.codex.overleaf` -> `%LOCALAPPDATA%\CodexOverleaf\native-host-runtime\com.codex.overleaf.json` | `~/.config/google-chrome/NativeMessagingHosts/com.codex.overleaf.json` | `~/.config/chromium/NativeMessagingHosts/com.codex.overleaf.json` |
346
346
  | Bridge/runtime/source path | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. | Bridge `%LOCALAPPDATA%\CodexOverleaf\codex-overleaf-bridge.cmd`; runtime `%LOCALAPPDATA%\CodexOverleaf\native-host-runtime`; source `%LOCALAPPDATA%\CodexOverleaf\source`. | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. |
347
347
  | Node/Git/Codex/TeX | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. |
@@ -12,7 +12,7 @@
12
12
  const MIN_NATIVE_VERSION = '1.0.0';
13
13
  const MIN_COMPATIBLE_NATIVE_VERSION = '1.0.0';
14
14
  const MIN_COMPATIBLE_EXTENSION_VERSION = '1.0.0';
15
- const BUILD_TARGET_VERSION = '1.8.3';
15
+ const BUILD_TARGET_VERSION = '1.8.4';
16
16
  const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
17
17
  const REQUIRED_CAPABILITIES = Object.freeze([
18
18
  'bridgePing',
@@ -1156,7 +1156,7 @@
1156
1156
  if (!s) continue;
1157
1157
  if (s.accountScopeId !== accountScopeId) continue;
1158
1158
  if (typeof s.lastActivityAt !== 'string' || !s.lastActivityAt) continue;
1159
- if (typeof s.projectId !== 'string' || !s.projectId) continue;
1159
+ if (!isValidOverleafProjectId(s.projectId)) continue;
1160
1160
  var prev = byProject[s.projectId];
1161
1161
  if (!prev || prev.lastActivityAt < s.lastActivityAt) {
1162
1162
  byProject[s.projectId] = s;
@@ -1188,6 +1188,10 @@
1188
1188
  return rows;
1189
1189
  }
1190
1190
 
1191
+ function isValidOverleafProjectId(value) {
1192
+ return typeof value === 'string' && /^[a-f0-9]{24}$/.test(value);
1193
+ }
1194
+
1191
1195
  // Per spec §5.10:
1192
1196
  // 1. trackedChangeStatus if set (pending/accepted/rejected/needs_review)
1193
1197
  // 2. else run status (running/completed/failed/background_completed/
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "codex-overleaf-link",
3
- "version": "1.8.3",
3
+ "version": "1.8.4",
4
4
  "description": "Cross-platform Chrome bridge that connects Codex to the active Overleaf project.",
5
5
  "license": "MIT",
6
6
  "type": "commonjs",
@@ -153,12 +153,18 @@ function getCurrentPackageTarballName() {
153
153
  }
154
154
 
155
155
  function runNpm(args) {
156
- const result = spawnSync(process.platform === 'win32' ? 'npm.cmd' : 'npm', args, {
157
- cwd: repoRoot,
158
- encoding: 'utf8',
159
- shell: process.platform === 'win32',
160
- windowsHide: true
161
- });
156
+ const result = process.platform === 'win32'
157
+ ? spawnSync(`npm.cmd ${args.map(quoteWindowsShellArg).join(' ')}`, {
158
+ cwd: repoRoot,
159
+ encoding: 'utf8',
160
+ shell: true,
161
+ windowsHide: true
162
+ })
163
+ : spawnSync('npm', args, {
164
+ cwd: repoRoot,
165
+ encoding: 'utf8',
166
+ windowsHide: true
167
+ });
162
168
 
163
169
  if (result.error) {
164
170
  throw result.error;
@@ -170,6 +176,14 @@ function runNpm(args) {
170
176
  return result.stdout;
171
177
  }
172
178
 
179
+ function quoteWindowsShellArg(arg) {
180
+ const value = String(arg);
181
+ if (/^[A-Za-z0-9._=:/-]+$/.test(value)) {
182
+ return value;
183
+ }
184
+ return `"${value.replace(/"/g, '\\"')}"`;
185
+ }
186
+
173
187
  function parsePackJsonText(text) {
174
188
  const parsed = JSON.parse(text);
175
189
  const packuments = Array.isArray(parsed) ? parsed : [parsed];