refactor(windows): replace wallpaper helper with isolated Python runtime

.github/workflows/electron-windows.yml

@@ -25,10 +25,13 @@ jobs:
           cache: npm
           cache-dependency-path: electron/package-lock.json
 
-      - uses: actions/setup-dotnet@v5
+      - uses: actions/setup-python@v7
         with:
-          # Pin the same SDK resolved by 8.0.x; avoid its broken aka.ms blob redirect.
-          dotnet-version: '8.0.427'
+          python-version: '3.12.10'
+
+      - name: Select the existing Python runtime
+        shell: pwsh
+        run: '"AMADEUS_PYTHON=$((Get-Command python).Source)" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append'
 
       - name: Install locked dependencies
         run: npm ci
@@ -81,7 +84,9 @@ jobs:
           if ($probe.ExitCode -ne 0) { throw "Startup settings smoke failed: $($probe.ExitCode)" }
 
       - name: Test Windows wallpaper lifecycle contracts
-        run: dotnet run --project ../wallpaper/windows/Amadeus.Wallpaper.Tests
+        run: |
+          python -m pip install pytest==8.4.2
+          python -m pytest ../tests/test_windows_wallpaper_helper.py
 
       - name: Build the unpacked Windows application including beforePack
         env:

.github/workflows/python-windows.yml

@@ -153,11 +153,6 @@ jobs:
           --report-dir build\electron-smoke
           --extension-fixture "${{ env.EXTENSION_RELEASE_FIXTURE }}" --extension-failures
 
-      - uses: actions/setup-dotnet@v5
-        with:
-          # Pin the same SDK resolved by 8.0.x; avoid its broken aka.ms blob redirect.
-          dotnet-version: '8.0.427'
-
       - name: Build actual Windows executable
         working-directory: electron
         env:

.github/workflows/source-release.yml

@@ -13,7 +13,7 @@ on:
       - electron/package-lock.json
       - scripts/**
       - wallpaper/**
-      - electron/scripts/build-windows-wallpaper.cjs
+      - electron/resources/windows-wallpaper/**
       - tools/build_source_release.py
       - tools/stage_japanese_dictionary.py
       - tools/probes/verify_bundled_dictionary.py
@@ -102,11 +102,6 @@ jobs:
         with:
           node-version: "22.21.1"
 
-      - uses: actions/setup-dotnet@v5
-        with:
-          # Pin the same SDK resolved by 8.0.x; avoid its broken aka.ms blob redirect.
-          dotnet-version: '8.0.427'
-
       - name: Install pinned uv
         run: python -m pip install uv==0.12.8
 

LICENSES/provenance.json

@@ -2,6 +2,7 @@
   "schema": "amadeus.third-party-provenance.v1",
   "last_reviewed": "2026-09-21",
   "inventory_roots": [
+    "electron/resources/windows-wallpaper",
     "GPT_SoVITS",
     "tools/AP_BWE_main",
     "tools/asr",
@@ -15,6 +16,20 @@
     "vendor/qwen-asr"
   ],
   "components": [
+    {
+      "id": "windows-wallpaper-wire-adapter",
+      "name": "Amadeus Windows wallpaper wire adapter",
+      "category": "adapted-source",
+      "paths": ["electron/resources/windows-wallpaper/**"],
+      "source_url": "https://github.com/cyanfish/grpc-dotnet-namedpipes",
+      "source_revision": "da307b551a9d56b62f5780e91a2d95a699f32430 (3.1.0 transport.proto and Windows message framing reference)",
+      "license_expression": "AGPL-3.0 AND Apache-2.0",
+      "license_evidence": ["LICENSE", "electron/resources/windows-wallpaper/NOTICE.md", "electron/resources/windows-wallpaper/Apache-2.0.txt"],
+      "modified": true,
+      "release_action": "include",
+      "gate_status": "ready",
+      "notes": "First-party standard-library Python helper implementing the bounded external Lively 2.2.1.0 IPC subset, with protocol/framing reference attribution preserved. No upstream .NET client, protobuf runtime, NuGet package, or .NET runtime binary is included. Lively remains separately supplied by its publisher."
+    },
     {
       "id": "gpt-sovits",
       "name": "GPT-SoVITS",

THIRD_PARTY_NOTICES.md

@@ -1,5 +1,13 @@
 # Third-party notices and pre-release provenance status
 
+The Windows wallpaper helper uses the existing Python runtime and ships no .NET
+or NuGet binaries. Its bounded wire adapter references GrpcDotNetNamedPipes 3.1.0
+at `da307b551a9d56b62f5780e91a2d95a699f32430` (Copyright 2020 Google LLC,
+Apache-2.0); attribution and license are included in
+`electron/resources/windows-wallpaper/NOTICE.md` and `Apache-2.0.txt`, with a
+matching provenance record. Lively remains an optional separately distributed
+GPL-3.0 application with its own prerequisites and notices.
+
 Status: **pre-release inventory — no known unresolved provenance component is
 selected as a release blocker under the stated immediate-upstream policy**.
 

electron/electron-builder-code-only.cjs

@@ -1,8 +1,7 @@
 // Explicit developer/CI shell; never label this as a full application distribution.
-const config = require('./package.json').build
+const { beforePack, ...config } = require('./package.json').build
 module.exports = {
   ...config,
   artifactName: 'amadeus-code-only-${version}-${arch}.${ext}',
-  beforePack: 'scripts/build-windows-wallpaper.cjs',
   extraResources: config.extraResources.filter(item => item.to !== 'assets/bundled/japanese-pronunciation'),
 }

electron/package.json

@@ -54,7 +54,7 @@
       "icon": "../assets/icons/app/app_icon.ico",
       "extraResources": [
         { "from": "../assets/icons/app/app_icon.ico", "to": "assets/icons/app/app_icon.ico" },
-        { "from": "../build/windows-wallpaper/host", "to": "windows-wallpaper", "filter": ["**/*", "!*.pdb"] },
+        { "from": "resources/windows-wallpaper", "to": "windows-wallpaper", "filter": ["*.py", "NOTICE.md", "Apache-2.0.txt"] },
         { "from": "../scripts/setup_windows_wallpaper.ps1", "to": "windows-wallpaper/setup_windows_wallpaper.ps1" }
       ]
     }

electron/resources/windows-wallpaper/NOTICE.md

@@ -0,0 +1,20 @@
+# Windows wallpaper helper
+
+Amadeus's helper is first-party AGPL-3.0 code and uses only Python's standard
+library. Python is supplied by the same runtime selection as the desktop backend;
+this resource does not bundle a Python or .NET runtime.
+
+The bounded RPC wire adapter was implemented with reference to the external
+GrpcDotNetNamedPipes protocol and framing at revision
+`da307b551a9d56b62f5780e91a2d95a699f32430` (3.1.0):
+https://github.com/cyanfish/grpc-dotnet-namedpipes/tree/da307b551a9d56b62f5780e91a2d95a699f32430
+
+Protocol/framing reference: Copyright 2020 Google LLC; Apache License 2.0,
+included in `Apache-2.0.txt`. No GrpcDotNetNamedPipes, Google.Protobuf,
+Grpc.Core.Api, System.Memory, or .NET runtime binaries are distributed here.
+The original source and pinned revision remain available at the URL above.
+
+The service field numbers describe Lively 2.2.1.0's external IPC interface.
+Lively is a separate optional GPL-3.0 application obtained from its publisher;
+its own prerequisites and notices are the responsibility of that distribution.
+Known reporting/close limitations are tracked in Amadeus #233.