arcane-os 0.74.0 → 0.75.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.75.0
+
+- Advertise whole-image `img2img` alongside `txt2img` for the built-in
+  `sdxl-base-1.0` selection. Use the existing public `images.edit()` operation
+  with the original PNG, complete prompt and explicit strength.
+- Reuse the complete SDXL Base checkpoint, embedded VAE and existing retained
+  native context. Preserve 1024-by-1024 defaults, caller-selected canvas,
+  progress, cancellation and complete separate PNG results. No additional
+  model resource, runtime, adapter or dependency is introduced.
+- Document the pinned engine's encoding/sampling path and whole-image editing
+  semantics. Masked/reference editing and pixel or output-quality guarantees
+  remain outside this selection; source review is not native execution proof.
+
 ## 0.74.0
 
 - Add optional `longPaths` to `createRepositoryWorkspace()` for newly cloned

package/README.md

@@ -20,7 +20,7 @@ selected SDK projection or an explicit live SDK source mount. Both profiles
 share the theme, packaging, event, cancellation,
 and browser run contracts while retaining their selected application layout.
 
-This checkout defines the `0.74.0` SDK contract. Development applications declare
+This checkout defines the `0.75.0` SDK contract. Development applications declare
 `arcane-os` as `latest` and retain their lockfile. Exact SDK pins begin when Roshi
 designates a production build. Follow [Consumer updates](docs/consumer-updates.md)
 to refresh and compare the installed SDK and lockfile with the published channel;

package/docs/reference/README.md

@@ -72,7 +72,7 @@ alone does not make bare module names resolve in a browser.
 | Run application-selected llama.cpp, Ollama or ONNX through Core | [Local AI through Core](local-ai.md) |
 | Generate complete local PNG images with a retained native model | [Local image generation](local-image-generation.md) |
 | Select FLUX.2 Klein 4B and its three complementary model resources | [FLUX.2 Klein 4B through Core](local-image-flux.md) |
-| Select the complete SDXL Base 1.0 checkpoint for text-to-image generation | [SDXL Base 1.0 through Core](local-image-sdxl.md) |
+| Select the complete SDXL Base 1.0 checkpoint for generation and whole-image editing | [SDXL Base 1.0 through Core](local-image-sdxl.md) |
 | Compose independently loaded transcription and synthesis engines | [Native speech service](native-speech.md) |
 | Keep a native Whisper model loaded across complete recordings | [Native Whisper transcription](local-whisper.md) |
 | Select the optional Intel NPU encoder with independent CUDA or CPU decoding | [Intel NPU Whisper](../guides/native-whisper-openvino.md) |
@@ -82,7 +82,7 @@ alone does not make bare module names resolve in a browser.
 | Retain a Nemotron model and diarize caller-fed audio streams | [Native speaker diarization](diarization.md) |
 | Persist application-selected preferences through Core | [Core preferences service](core-preferences.md) |
 | Read complete selected Git text without changing a checkout | [Git text snapshots](git-text-snapshot.md) |
-| Own a native working checkout under per-user ArcaneData/Repos | [Native repository workspaces](core-repositories.md) |
+| Own a native working checkout under per-user ArcaneData/Repos, with optional Windows long paths for new clones | [Native repository workspaces](core-repositories.md) and [Windows clone configuration](core-repositories.md#windows-long-paths-for-a-new-checkout) |
 | Read Git identity defaults or select child-only author and credential hints | [Git identity configuration](core-repositories.md#git-identity-configuration) |
 | Write, commit and push complete selected repository text | [Selected-text repository writing](core-repositories.md#write-commit-and-push-selected-text) |
 | Observe existing checkout configuration and capture an explicit remote/ref | [Repository configuration and selected targets](core-repositories.md#existing-checkout-configuration-and-selected-targets) |

package/docs/reference/inventory/package-api.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "sdkVersion": "0.73.0",
+  "sdkVersion": "0.74.0",
   "environment": {
     "runtime": "Node.js for Node entrypoints; browser for browser-only entrypoints",
     "minimumVersion": "22.23.2 for Node entrypoints",

package/docs/reference/local-image-editing.md

@@ -1,8 +1,9 @@
 # Local image editing through Core
 
 `createCoreImageRuntime()` exposes whole-image img2img through `edit()`, using
-the same retained native context as generation. The selected SD1.4 model
-advertises `txt2img` and `img2img`. Applications supply the original PNG, the
+the same retained native context as generation. The built-in SD1.4 and
+[SDXL Base 1.0](local-image-sdxl.md#edit-a-whole-image) models advertise
+`txt2img` and `img2img`. Applications supply the original PNG, the
 complete prompt and explicit strength, retain the original, and decide whether
 to save the separate generated result.
 
@@ -149,6 +150,8 @@ own model-specific contracts and are outside this PNG img2img operation.
 Ordinary img2img does not require LoRA training. The selected engine documents
 this directly with its base SD1.4 model in the
 [tagged img2img example](https://github.com/leejet/stable-diffusion.cpp/blob/master-929-3f8527a/docs/sd.md#img2img-example).
+The complete SDXL Base checkpoint uses its embedded VAE through the same
+image pipeline; see the [SDXL model and operation guide](local-image-sdxl.md).
 
 Source dimensions are decoder output, not an implicit request to change the
 generation dimensions. The engine center-crops and resizes temporary initial
@@ -157,7 +160,7 @@ Caller images remain unchanged;
 even `mode=none` does not suppress all later model adaptation. See the
 [native preprocessing contract](https://github.com/leejet/stable-diffusion.cpp/blob/master-929-3f8527a/docs/image_preprocessing.md).
 
-An RGB-only model such as the selected SD1.4 consumes the stored RGB
+An RGB-only model such as the selected SD1.4 or SDXL consumes the stored RGB
 and does not preserve alpha. The SDK must not silently choose a compositing
 background or claim that passing RGBA preserves its displayed appearance.
 Strength zero is also not an exact-copy operation: native img2img still uses

package/docs/reference/local-image-generation.md

@@ -50,7 +50,8 @@ editing or imply the same input path as SD1.4 img2img.
 `sdxl-base-1.0` selects the complete SDXL Base checkpoint, including its text
 encoders and original VAE. Its [family guide](local-image-sdxl.md) covers the
 single model resource, 1024-by-1024 default canvas and native sampling defaults.
-It advertises `txt2img`; selecting it does not enable an editing operation.
+It advertises `txt2img` and whole-image `img2img` through the same public
+`edit()` operation, using the checkpoint's embedded VAE and retained context.
 
 The first published distribution path selects CPU on Windows and Linux.
 On macOS, `auto` selects the same upstream universal runtime's built-in Metal

package/docs/reference/local-image-sdxl.md

@@ -1,8 +1,8 @@
 # SDXL Base 1.0 through Core
 
 The `sdxl-base-1.0` model definition selects Stability AI's complete SDXL Base
-1.0 checkpoint for text-to-image generation through the shared
-[local image runtime](local-image-generation.md). Applications supply their
+1.0 checkpoint for text-to-image generation and whole-image img2img through the
+shared [local image runtime](local-image-generation.md). Applications supply their
 own complete prompts and own the resulting images and saved associations.
 The model uses the shared retained native context, progress, cancellation
 and complete PNG result contract.
@@ -40,8 +40,8 @@ selection alone does not establish actual execution on any device.
 The single `model` resource is the official
 [`sd_xl_base_1.0.safetensors` checkpoint](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/resolve/462165984030d82259a11f4367a4eed129e94a7b/sd_xl_base_1.0.safetensors)
 at revision `462165984030d82259a11f4367a4eed129e94a7b`. It includes the text
-encoders, denoiser and original VAE. Standalone base generation uses this one
-resource; a refiner, separate VAE, LoRA or Python converter is unnecessary for
+encoders, denoiser and original VAE. Generation and whole-image editing use this
+one resource; a refiner, separate VAE, LoRA or Python converter is unnecessary for
 this selection. The upstream model carries the
 [CreativeML Open RAIL++-M license](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/LICENSE.md).
 
@@ -107,6 +107,39 @@ Repeated generation reuses the loaded context; unload it when the application
 no longer needs it. Follow the shared lifecycle contract for request
 cancellation, state subscriptions, unloading and accessor closure.
 
+## Edit a whole image
+
+After loading the same model, pass an original PNG and an explicit strength to
+the existing public accessor. `originalPNG` is the application's PNG Blob or
+File; the application retains it and decides whether to save the new result.
+
+```javascript
+const edited = await images.edit({
+    model: 'sdxl-base-1.0',
+    image: originalPNG,
+    prompt: 'The octopus librarian now wears a purple knitted diving helmet.',
+    strength: 0.6,
+    signal
+});
+// Display edited.images using the same complete PNG Blob result contract.
+```
+
+This is whole-image img2img, using the checkpoint's embedded VAE encoder,
+denoiser and decoder. It needs no additional model resource, adapter or engine.
+The operation reuses the same loaded context and progress/cancellation owners
+as generation. The SDK forwards the complete prompt and original PNG; it does
+not add style instructions or save either the request or result.
+
+The model still defaults to a 1024-by-1024 canvas. Supply
+`parameters: {width, height}` when choosing another output canvas; input
+dimensions do not silently replace that selection. The native engine adapts
+the initial raster to the selected canvas and denoises the whole image.
+Framing, texture, identity and individual pixels are model results, not
+preservation guarantees. Strength zero is not an exact-copy operation, and
+the RGB model does not preserve alpha. See the shared
+[editing contract](local-image-editing.md) for supported PNG encodings,
+native preprocessing, full-result handling and cancellation.
+
 ## Defaults and operation scope
 
 Only canvas dimensions are model-specific defaults here. Sampling parameters
@@ -127,9 +160,9 @@ applies its own text conditioning and prompt-weighting syntax; see the shared
 guide for native string-boundary limitations. The SDK adds no avatar wording,
 style instructions or application-specific content.
 
-This definition advertises `txt2img`. Whole-image editing, masked editing and
-reference-image editing are separate operations with their own model and
-runtime requirements. This base selection does not advertise those operations.
+This definition advertises `txt2img` and `img2img`. Masked and reference-image
+editing are separate operations with their own model and runtime requirements;
+this base selection does not advertise them.
 
 The model resource and standalone use follow the
 [official model card](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/README.md).
@@ -137,3 +170,7 @@ Native defaults and embedded-VAE behavior follow the selected engine's
 [request implementation](https://github.com/leejet/stable-diffusion.cpp/blob/master-929-3f8527a/src/pipeline/request.cpp),
 [parameter initialization](https://github.com/leejet/stable-diffusion.cpp/blob/master-929-3f8527a/src/stable-diffusion.cpp)
 and [model construction](https://github.com/leejet/stable-diffusion.cpp/blob/master-929-3f8527a/src/pipeline/model_builders.cpp).
+The pinned [image pipeline](https://github.com/leejet/stable-diffusion.cpp/blob/3f8527a/src/pipeline/image.cpp)
+encodes the initial image, samples its latent and decodes the result. That
+implementation establishes the operation path; source inspection alone does
+not establish execution, output quality or device performance.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.74.0",
+  "version": "0.75.0",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",

package/src/local-ai/image-models/sdxl.mjs

@@ -14,5 +14,5 @@ export const SDXL_BASE_1_0_MODEL = {
         width: 1024,
         height: 1024
     },
-    operations: ['txt2img']
+    operations: ['txt2img', 'img2img']
 };