chore(release): add Firefox artifacts to nightly/release, bump to 0.12.14, update docs and local packaging

Author: justrach

.github/workflows/nightly.yml

@@ -32,14 +32,17 @@ jobs:
       - name: Build extension and MCP server (Bun)
         run: bun run build:all
 
-      - name: Prepare nightly extension package
+      - name: Build Firefox extension (Bun)
+        run: bun run build:firefox
+
+      - name: Prepare nightly extension package (Chrome)
         id: pkg
         shell: bash
         run: |
           set -euo pipefail
           RUN_NUMBER="${GITHUB_RUN_NUMBER}"
           SHA_SHORT=$(git rev-parse --short HEAD)
-          PKG_NAME="jan-extension-nightly-${RUN_NUMBER}-${SHA_SHORT}.zip"
+          PKG_NAME="jan-extension-chrome-nightly-${RUN_NUMBER}-${SHA_SHORT}.zip"
           mkdir -p pack/extension
           # Copy required extension files
           cp -r dist icons src pack/extension/
@@ -54,6 +57,18 @@ jobs:
           (cd pack/extension && zip -r "../../${PKG_NAME}" .)
           echo "pkg_name=${PKG_NAME}" >> "$GITHUB_OUTPUT"
 
+      - name: Prepare nightly extension package (Firefox)
+        id: pkg_ff
+        shell: bash
+        run: |
+          set -euo pipefail
+          RUN_NUMBER="${GITHUB_RUN_NUMBER}"
+          SHA_SHORT=$(git rev-parse --short HEAD)
+          PKG_FF_NAME="jan-extension-firefox-nightly-${RUN_NUMBER}-${SHA_SHORT}.zip"
+          # Zip the firefox dist root as the extension package
+          (cd dist-firefox && zip -r "../${PKG_FF_NAME}" .)
+          echo "pkg_ff_name=${PKG_FF_NAME}" >> "$GITHUB_OUTPUT"
+
       - name: Package MCP search server (optional asset)
         id: mcp
         shell: bash
@@ -77,6 +92,7 @@ jobs:
           if-no-files-found: warn
           path: |
             ${{ steps.pkg.outputs.pkg_name }}
+            ${{ steps.pkg_ff.outputs.pkg_ff_name }}
             ${{ steps.mcp.outputs.mcp_zip }}
 
       - name: Create/Update Nightly Release
@@ -86,9 +102,15 @@ jobs:
           name: Nightly Builds
           draft: false
           prerelease: true
+          body: |
+            Nightly builds for Jan Extension.
+
+            - Includes Chrome and Firefox extension packages.
+            - Firefox artifacts are built from `manifest.firefox.json` and `dist-firefox`.
+            - Zips are suffixed with run and commit for traceability.
           files: |
             ${{ steps.pkg.outputs.pkg_name }}
+            ${{ steps.pkg_ff.outputs.pkg_ff_name }}
             ${{ steps.mcp.outputs.mcp_zip }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-

.github/workflows/release.yml

@@ -30,13 +30,16 @@ jobs:
       - name: Build extension and MCP server (Bun)
         run: bun run build:all
 
-      - name: Prepare extension package
+      - name: Build Firefox extension (Bun)
+        run: bun run build:firefox
+
+      - name: Prepare extension package (Chrome)
         id: pkg
         shell: bash
         run: |
           set -euo pipefail
           TAG="${GITHUB_REF_NAME}"
-          PKG_NAME="jan-extension-${TAG}.zip"
+          PKG_NAME="jan-extension-chrome-${TAG}.zip"
           mkdir -p pack/extension
           # Copy required extension files
           cp -r manifest.json dist icons src pack/extension/
@@ -47,6 +50,16 @@ jobs:
           (cd pack/extension && zip -r "../../${PKG_NAME}" .)
           echo "pkg_name=${PKG_NAME}" >> "$GITHUB_OUTPUT"
 
+      - name: Prepare extension package (Firefox)
+        id: pkg_ff
+        shell: bash
+        run: |
+          set -euo pipefail
+          TAG="${GITHUB_REF_NAME}"
+          PKG_FF_NAME="jan-extension-firefox-${TAG}.zip"
+          (cd dist-firefox && zip -r "../${PKG_FF_NAME}" .)
+          echo "pkg_ff_name=${PKG_FF_NAME}" >> "$GITHUB_OUTPUT"
+
       - name: Package MCP search server (optional asset)
         id: mcp
         shell: bash
@@ -69,6 +82,7 @@ jobs:
           if-no-files-found: warn
           path: |
             ${{ steps.pkg.outputs.pkg_name }}
+            ${{ steps.pkg_ff.outputs.pkg_ff_name }}
             ${{ steps.mcp.outputs.mcp_zip }}
 
       - name: Create GitHub Release and upload assets
@@ -79,8 +93,15 @@ jobs:
           name: Jan Extension ${{ github.ref_name }}
           draft: false
           prerelease: false
+          body: |
+            Firefox support: Added official Firefox build artifact alongside Chrome.
+
+            - Artifacts: `jan-extension-chrome-${{ github.ref_name }}.zip`, `jan-extension-firefox-${{ github.ref_name }}.zip`.
+            - Notes: Firefox package is built from `manifest.firefox.json` and zipped from `dist-firefox`.
+            - MCP Server (optional): included as `search-mcp-server-${{ github.ref_name }}-dist.zip` when present.
           files: |
             ${{ steps.pkg.outputs.pkg_name }}
+            ${{ steps.pkg_ff.outputs.pkg_ff_name }}
             ${{ steps.mcp.outputs.mcp_zip }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

PR.md

@@ -1,49 +1,73 @@
-# Jan Extension — Options Models Refresh Fix
-
-## Summary
-Fixes a bug where the Options page required a hard refresh before the model list updated after changing provider/API settings.
-
-## Root Cause
-`LIST_MODELS` in the background read from `chrome.storage.sync` only, while the Options UI had unsaved local state. The UI would fetch models before saving, and the background saw stale values, leading to "Missing API Base URL" or empty results until a reload.
-
-## Files Changed
-```
-src/background.js
-ui/options/App.jsx
-```
-
-## Changes Overview
-- **Background (`src/background.js`)**: `LIST_MODELS` now accepts overrides in `message.payload` (`apiBase`, `apiKey`, `useApiKey`). Falls back to `getSettings()` only when overrides are not provided.
-- **Options UI (`ui/options/App.jsx`)**: Model fetch effect now sends overrides to `LIST_MODELS` with current config values, adds guards to avoid errors while editing, and immediately refetches models after Save.
-
-## Type of Change
-- [x] Bug fix (non-breaking change which fixes an issue)
-- [ ] Hotfix (critical fix requiring immediate deployment)
-- [ ] New feature
-- [ ] Breaking change
-- [x] Code refactoring
-- [ ] TypeScript migration
-
-## Testing Checklist
-- [ ] Changes tested locally
-- [ ] Model list updates immediately after changing settings without hard refresh
-- [ ] No error messages flash while typing in Options
-- [ ] Save functionality works correctly
-- [ ] Refresh button works as expected
-- [ ] Extension reload not required
-
-## Deployment Notes
-Standard deployment process; extension reload required for users to see the fix.
-
-## Additional Context 
-This fix addresses a UX issue in the Jan extension Options page where users had to reload the extension to see updated model lists after changing API settings. The changes are backward-compatible and only affect the Options page model fetching behavior.
-
-## Reviewer Focus Areas
-- [ ] Background message handling changes
-- [ ] Options UI state management
-- [ ] Error handling improvements
-- [ ] Backward compatibility
-
----
-
-**Ready for review and deployment** 🚀
+Title: Firefox support + Nightly/Release artifacts + bump to 0.12.14
+
+Summary
+- Add official Firefox build and attach Firefox zips in Nightly and tagged Releases.
+- Keep Chrome build unchanged, but publish separate artifacts for clarity.
+- Bump versions to 0.12.14 across root package and both manifests.
+
+What’s included
+- CI: Add Firefox to Nightly and Release workflows
+  - Nightly: builds Firefox and uploads `jan-extension-firefox-nightly-<run>-<sha>.zip`.
+  - Release: builds Firefox and uploads `jan-extension-firefox-<tag>.zip`.
+  - Chrome artifacts are now explicitly `jan-extension-chrome-*.zip` to avoid confusion.
+- Version bumps
+  - package.json → 0.12.14
+  - manifest.json → 0.12.14
+  - manifest.firefox.json → 0.12.14
+- Local packaging
+  - `scripts/package-local.sh` now builds Firefox and produces a Firefox zip alongside Chrome.
+- Docs
+  - `RELEASE.md` updated to reflect Chrome/Firefox artifact names and Nightly behavior.
+
+Rationale
+- Provide first-class Firefox support: a reproducible build and downloadable artifact.
+- Clear artifact naming (`-chrome-` / `-firefox-`) removes ambiguity for users and CI consumers.
+
+Files changed
+- .github/workflows/nightly.yml
+- .github/workflows/release.yml
+- scripts/package-local.sh
+- package.json
+- manifest.json
+- manifest.firefox.json
+- RELEASE.md
+
+How to test locally
+1) Firefox build
+   - `bun run build:firefox` (or `npm run build:firefox`)
+   - Verify `dist-firefox/` contains: `manifest.json`, `icons/`, `src/`, `ui/`, `assets/`.
+2) Load in Firefox (temporary add-on)
+   - Open `about:debugging#/runtime/this-firefox` → Load Temporary Add-on… → select any file in `dist-firefox/`.
+   - Sanity checks:
+     - Sidebar opens and renders side panel UI.
+     - Inline Assistant shows on text selection and can Apply/Copy.
+     - Commands/shortcuts respond (e.g., open panel, custom prompt, toggle autocomplete).
+     - Page summarization works and streams output.
+3) Chrome sanity (unchanged flow)
+   - `bun run build` then load `dist/` via `chrome://extensions` → Load unpacked.
+4) Local packaging
+   - `TAG=test-local bash scripts/package-local.sh`
+   - Inspect `pack/jan-extension-chrome-test-local.zip` and `pack/jan-extension-firefox-test-local.zip` contents.
+
+CI/Release behavior
+- Nightly (push to main):
+  - Uploads: Chrome and Firefox nightly zips, plus MCP zip if present.
+- Tagged release (push tag):
+  - Uploads: `jan-extension-chrome-<tag>.zip`, `jan-extension-firefox-<tag>.zip`, and `search-mcp-server-<tag>-dist.zip` (if present).
+
+Release notes (proposed)
+- Firefox support: Official Firefox build and downloadable artifact on Releases and Nightlies.
+- Chrome + Firefox artifacts: Explicit platform suffixes for clarity.
+- Version: 0.12.14.
+
+Compatibility / migration
+- No changes to runtime behavior for Chrome users.
+- Artifact names changed; any downstream automation that expected `jan-extension-<tag>.zip` should update to `jan-extension-chrome-<tag>.zip`.
+
+Checklist
+- [ ] Firefox: sidebar opens and renders side panel UI
+- [ ] Firefox: Inline Assistant operates on selected text
+- [ ] Firefox: Page summarization streams and completes
+- [ ] Chrome: basic sanity unchanged
+- [ ] Release artifact names validated in CI logs
+

RELEASE.md

@@ -12,7 +12,8 @@ This doc explains how to ship downloadable zips for the Chrome extension and the
   git push origin 12.11
   ```
   CI publishes:
-  - `jan-extension-12.11.zip`
+  - `jan-extension-chrome-12.11.zip`
+  - `jan-extension-firefox-12.11.zip`
   - `search-mcp-server-12.11-dist.zip`
 
 - Nightly prerelease (incremental):
@@ -50,14 +51,18 @@ git tag 12.11 && git push origin main && git push origin 12.11
   - Trigger: tag pushes (`vX.Y.Z`, `X.Y.Z`, or custom like `12.11`).
   - Tooling: Bun (`oven-sh/setup-bun@v2`) for `bun install` and `bun run build:all`.
   - Artifacts:
-    - `jan-extension-<tag>.zip`: `manifest.json`, `src/background.js`, `src/content.js`, `dist/ui/*`, `dist/assets/*`, `icons/*`, plus `LICENSE`/`README.md` if present.
+    - `jan-extension-chrome-<tag>.zip`: `manifest.json`, `src/*`, `dist/**`, `icons/*`, plus `LICENSE`/`README.md` if present.
+    - `jan-extension-firefox-<tag>.zip`: zipped from `dist-firefox/**` built via `npm run build:firefox`.
     - `search-mcp-server-<tag>-dist.zip`: `mcp/search-server/dist/**` (if present).
   - Publishes a GitHub Release for the tag.
 
 - Nightly: `.github/workflows/nightly.yml`
   - Trigger: push to `main`.
-  - Patches `manifest.version_name` to include `-nightly-<run>-<sha>` (does not change `version`).
-  - Updates prerelease with tag `nightly` and uploads the two artifacts.
+  - Patches Chrome `manifest.version_name` to include `-nightly-<run>-<sha>` (does not change `version`).
+  - Updates prerelease with tag `nightly` and uploads:
+    - `jan-extension-chrome-nightly-<run>-<sha>.zip`
+    - `jan-extension-firefox-nightly-<run>-<sha>.zip`
+    - `search-mcp-server-nightly-<run>-<sha>-dist.zip`
 
 ## Local Packaging Details
 
@@ -68,7 +73,8 @@ git tag 12.11 && git push origin main && git push origin 12.11
 
 - Verify contents:
 ```bash
-unzip -l pack/jan-extension-<tag>.zip | sed -n '1,200p'
+unzip -l pack/jan-extension-chrome-<tag>.zip | sed -n '1,200p'
+unzip -l pack/jan-extension-firefox-<tag>.zip | sed -n '1,200p'
 ```
 
 ## Optional: Run CI Locally
@@ -91,4 +97,3 @@ The workflow uploads artifacts; publishing to GitHub Releases is skipped under `
   ```
 - Bun: we track `latest`. If CI regresses, pin `bun-version: 1.2.x`.
 - Chrome: unzip the extension zip and load as unpacked via `chrome://extensions`.
-

manifest.firefox.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Jan",
-  "version": "0.12.12",
+  "version": "0.12.14",
   "description": "The Jan companion for your browser: chat, inline writing help, search, and page context in the sidebar.",
   "browser_specific_settings": {
     "gecko": {

manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Jan",
-  "version": "0.12.13",
+  "version": "0.12.14",
   "description": "The Jan companion for your browser: chat, inline writing help, search, and page context in the side panel.",
   "icons": {
     "16": "icons/app-16.png",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "jan-browser-extension",
-  "version": "0.12.13",
+  "version": "0.12.14",
   "description": "A Manifest V3 Chrome extension that summarizes the current page (or selected text) using any OpenAI-compatible API, including Cerebras and Jan Server.",
   "type": "module",
   "main": "index.js",

scripts/package-local.sh

@@ -26,6 +26,8 @@ if command -v bun >/dev/null 2>&1; then
   fi
   echo "[local-release] Building all targets with Bun"
   bun run build:all
+  echo "[local-release] Building Firefox extension"
+  bun run build:firefox
 else
   echo "[local-release] Bun not found; falling back to npm"
   echo "[local-release] Installing root deps..."
@@ -42,6 +44,8 @@ else
   fi
   echo "[local-release] Building all targets..."
   npm run build:all
+  echo "[local-release] Building Firefox extension"
+  npm run build:firefox
 fi
 
 echo "[local-release] Packaging extension..."
@@ -51,7 +55,14 @@ cp -r manifest.json dist icons src pack/extension/
 [[ -f LICENSE ]] && cp LICENSE pack/extension/ || true
 [[ -f README.md ]] && cp README.md pack/extension/ || true
 
-(cd pack/extension && zip -r "../jan-extension-${TAG}.zip" . >/dev/null)
+(cd pack/extension && zip -r "../jan-extension-chrome-${TAG}.zip" . >/dev/null)
+
+echo "[local-release] Packaging Firefox extension..."
+if [[ -d dist-firefox ]]; then
+  (cd dist-firefox && zip -r "../pack/jan-extension-firefox-${TAG}.zip" . >/dev/null)
+else
+  echo "[local-release] dist-firefox not found; skipping Firefox zip."
+fi
 
 echo "[local-release] Packaging MCP server (if present)..."
 if [[ -d mcp/search-server/dist ]]; then