arcane-os 0.39.0 → 0.39.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.39.1
+
+- Preserve the Markdown editor's current source viewport and selection during
+  configuration, programmatic value changes, preview rendering and toolbar
+  formatting. Keep the live textarea attached; only the preview follows edits.
+  Native typing, manual scrolling, complete content and save behavior remain
+  independent and unchanged.
+- Generate default Chat filenames with a timestamp and an independent native
+  random identifier so sessions created in the same clock tick do not share a
+  storage name. Preserve explicit and saved filenames, existing stored content,
+  persistence format and request-only `persist:false` behavior.
+- Detect continuous-capture activity using fixed 20 ms RMS audio windows so
+  brief background peaks do not indefinitely postpone quiet-gap segments.
+  Preserve complete original samples, pre-roll, periodic clip adjacency and
+  partial final flush. `activityThreshold` now measures sustained RMS level;
+  callers retain control of sensitivity for softer input.
+
 ## 0.39.0
 
 - Add application-owned assistant display names to new Chat turns through

package/README.md

@@ -19,7 +19,7 @@ version-locked SDK runtime, while an integrated Arcane checkout uses its live
 `arcane/` runtime. Both profiles share the theme, packaging, event, cancellation,
 and browser run contracts while retaining their selected application layout.
 
-This checkout defines the `0.39.0` SDK contract. Applications pin one exact npm
+This checkout defines the `0.39.1` SDK contract. Applications pin one exact npm
 version and lockfile; registry state is deliberately not baked into application
 artifacts.
 

package/docs/reference/inventory/runtime-components.json

@@ -535,7 +535,7 @@
       ],
       "availability": "Browser and supported native WebViews",
       "transport": "HTMLImport + DOM; injected Arcane/provider modules where listed",
-      "normalization": "Editor values and optional presentation behavior normalized; injected save result mixed. fit and followPreview default false, preserve omitted prior configuration, and accept explicit false resets; data-fit and data-follow-preview select the initial options. Fit requires an application-bounded host and provides independent input/preview scrolling in roomy columns or narrow stacked panes without changing the application shell. Following responds to body typing/format edits, leaves manual preview scrolling independent until the next edit, and does not treat title edits or programmatic value replacement as follow requests. Public parts editor/title/toolbar/input/preview/actions/status/save-action allow application styling while the title stays native plain text. Existing controls, complete save payload, save cancellation, and destruction behavior remain."
+      "normalization": "Editor values and optional presentation behavior normalized; injected save result mixed. fit and followPreview default false, preserve omitted prior configuration, and accept explicit false resets; data-fit and data-follow-preview select the initial options. Fit requires an application-bounded host and provides independent input/preview scrolling in roomy columns or narrow stacked panes without changing the application shell. Following responds to body typing/format edits, leaves manual preview scrolling independent until the next edit, and does not treat title edits or programmatic value replacement as follow requests. Preview rendering preserves the current source viewport and selection; configuration/value replacement retain source offsets and applicable selection positions, and layout changes never reattach the textarea. Formatting selects the formatted text without panning the source or its ancestors. Native typing, keyboard selection, and manual source scrolling remain independent without deferred scroll restoration. Public parts editor/title/toolbar/input/preview/actions/status/save-action allow application styling while the title stays native plain text. Existing controls, complete save payload, save cancellation, and destruction behavior remain."
     },
     {
       "file": "runtime/arcane/components/media-embed.html",

package/docs/reference/inventory/runtime-entities.json

@@ -9,7 +9,7 @@
   "modules": [
     {"file":"runtime/arcane/entities/ApiModelRecord.js","exports":["default"],"availability":"cross-host","normalization":"normalized"},
     {"file":"runtime/arcane/entities/Calculation.js","exports":["default"],"availability":"cross-host","normalization":"normalized"},
-    {"file":"runtime/arcane/entities/Chat.js","exports":["default"],"availability":"browser/native-webview","normalization":"Provider-facing recurring messages preserve raw structural protocol only for the one active matching continuation, then replace settled exchanges with complete ordinary visible content; transcript records remain sanitized and readable, including ui_hidden rows. aiName defaults to empty; addAIMessage and addTurn capture an optional exact nonblank application-owned name on new assistant records only. Provider names do not establish display attribution; assistant display names stay out of messages and memory extraction, and existing records are never renamed or rewritten. ordered parallel structural calls require one exact nonblank result for every pending ID in one atomic turn, with rollback-safe persistence."},
+    {"file":"runtime/arcane/entities/Chat.js","exports":["default"],"availability":"browser/native-webview","normalization":"New default filenames combine the timestamp with an independent random identifier; explicit and saved filenames remain unchanged. Provider-facing recurring messages preserve raw structural protocol only for the one active matching continuation, then replace settled exchanges with complete ordinary visible content; transcript records remain sanitized and readable, including ui_hidden rows. aiName defaults to empty; addAIMessage and addTurn capture an optional exact nonblank application-owned name on new assistant records only. Provider names do not establish display attribution; assistant display names stay out of messages and memory extraction, and existing records are never renamed or rewritten. ordered parallel structural calls require one exact nonblank result for every pending ID in one atomic turn, with rollback-safe persistence."},
     {"file":"runtime/arcane/entities/CommunicationMessage.js","exports":["communicationChannels","default"],"availability":"cross-host","normalization":"normalized"},
     {"file":"runtime/arcane/entities/CommunicationThread.js","exports":["default"],"availability":"cross-host","normalization":"normalized"},
     {"file":"runtime/arcane/entities/Document.js","exports":["default"],"availability":"browser/native-webview","normalization":"mixed"},

package/docs/reference/inventory/runtime-modules.json

@@ -1393,7 +1393,7 @@
       "summary": "Segments microphone samples on the audio rendering thread and transfers complete mono Float32 WAV clips to ContinuousVoiceCapture.",
       "availability": "AudioWorkletGlobalScope",
       "protocol": "AudioWorklet processor arcane-continuous-voice-capture and its owner-local MessagePort",
-      "normalization": "Rolling pre-roll, amplitude activity, quiet and periodic boundaries, sequence, complete WAV audio, and stop acknowledgement are owned here. Silence does not emit clips; adjacent periodic clips have no repeated samples.",
+      "normalization": "Rolling pre-roll, fixed 20 ms RMS activity windows independent of callback length, audio-frame quiet duration, periodic boundaries, sequence, complete original WAV audio, and stop acknowledgement are owned here. activityThreshold is RMS amplitude, not peak amplitude. Stop classifies a partial final window using its actual samples and retains softer trailing audio in the active clip. Inactive capture emits no clips; adjacent periodic clips have no repeated samples.",
       "surface": "No ESM exports. ContinuousVoiceCapture loads this static worklet, supplies processorOptions, receives segment messages, and requests stop followed by the stopped acknowledgement."
     },
     {

package/docs/reference/runtime-components.md

@@ -1067,6 +1067,14 @@ programmatic value replacement, and ordinary preview scrolling do not request
 edit-position following. Moving the selection alone does not trigger following,
 and following never scrolls the input pane or containing page. The title
 remains a native plain-text input.
+Preview rendering preserves the source pane's current horizontal and vertical
+scroll offsets and selection. Value replacement and reconfiguration retain
+those offsets and the selection positions that still fit the new text; layout
+changes move only the preview, keeping the live textarea attached. Toolbar
+formatting focuses the source without scrolling its ancestors, selects the
+formatted text, and preserves the source viewport. Native typing, keyboard
+selection, and manual source scrolling retain their ordinary behavior; there
+is no scroll lock or deferred restoration of an earlier source position.
 Following uses the shared [Markdown block mapping](runtime-modules.md#mdjs);
 lists, quotes, and tables follow their block, while invisible source positions
 use a nearby available rendered block rather than exact glyph geometry.

package/docs/reference/runtime-entities.md

@@ -73,6 +73,11 @@ console.log(new Calculation({expression: '2 + 2', result: 4}).toJSON());
 and optional app-scoped DBOPFS persistence. It installs no independent native
 authority; AI and storage dependencies must be available to the host.
 
+Each new chat receives a timestamp plus independently generated random identifier
+in its default `.jsonl` filename, so chats created during the same clock tick do
+not share a storage key. Explicit filenames and existing saved files remain
+unchanged; no saved records are renamed or migrated.
+
 `messages` returns provider-facing recurring context. An unresolved structural
 call and its matching results remain raw only through their one active provider
 continuation. Once that continuation settles, `messages` replaces the protocol

package/docs/reference/runtime-modules.md

@@ -4069,7 +4069,7 @@ Load with a stylesheet link before rendering uPlot charts.
 ### Overview
 
 Internal audio processor for [`ContinuousVoiceCapture.js`](#continuousvoicecapturejs).
-It keeps rolling pre-roll, detects audio amplitude, preserves complete active
+It keeps rolling pre-roll, detects RMS audio level, preserves complete active
 audio through quiet and periodic cuts, and encodes mono Float32 WAV clips on
 the audio rendering thread. It performs no semantic speech detection or STT.
 
@@ -4079,6 +4079,22 @@ No ESM exports. The capture owner loads this static file with
 `audioContext.audioWorklet.addModule()` and creates the
 `arcane-continuous-voice-capture` processor with
 `{preRollMs,quietMs,chunkMs,activityThreshold}` in `processorOptions`.
+`activityThreshold` measures root-mean-square amplitude over fixed 20 ms
+windows counted from the audio sample rate, independently of browser callback
+lengths. Brief peaks do not reset the quiet duration when the window's RMS
+remains below that threshold. This is an RMS threshold, not a peak threshold:
+a sine wave with peak amplitude `0.025` can remain below the default `0.02`
+RMS threshold. Applications can select the existing threshold for their audio
+level; no relative-noise or semantic speech classifier is implied.
+
+Classification selects segment boundaries without modifying the captured
+samples. Quiet duration advances by audio frames, pre-roll remains complete,
+and periodic clips remain adjacent. Stop classifies any partial final window
+using its actual samples and flushes the final active clip, including softer
+trailing audio before the quiet boundary. Analysis adds at most one 20 ms
+window of capture-to-segmentation delay; model processing is independently
+owned by the transcription queue.
+
 The owner sends `{type:'stop'}`. The processor transfers each complete
 `{type:'segment',audio:ArrayBuffer,sampleRate,sequence,reason,durationMs}`
 and finally `{type:'stopped'}`. Each complete WAV includes its own format,

package/package.json

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

package/runtime/arcane/components/markdown-editor.html

@@ -224,6 +224,7 @@
         if(destroyed){
             return false;
         }
+        const sourceView = captureSourceView();
         const setInitialValue=Object.prototype.hasOwnProperty.call(
             input||{},
             'initialValue'
@@ -240,9 +241,12 @@
         }
         if(setInitialValue){
             supersedeSave('markdown-content-replaced');
-            textarea.value=options.initialValue;
+            if (textarea.value !== options.initialValue) {
+                textarea.value = options.initialValue;
+            }
         }
         updatePreview();
+        restoreSourceView(sourceView);
         return getOptions();
     }
 
@@ -250,13 +254,14 @@
         host.dataset.fit=String(options.fit);
         editor.classList.toggle('fit',options.fit);
         editor.classList.toggle('without-preview',!options.showPreview);
-        // Keyboard order follows the displayed order in each layout.
-        if(options.fit){
-            editor.insertBefore(toolbar,preview);
-            editor.insertBefore(textarea,preview);
-        }else{
-            editor.insertBefore(preview,toolbar);
-            editor.insertBefore(textarea,toolbar.nextSibling);
+        // Move only the preview when the layout changes. Reattaching the live
+        // textarea during ordinary configuration would disturb focus/selection.
+        if (options.fit) {
+            if (textarea.nextSibling !== preview) {
+                editor.insertBefore(preview, textarea.nextSibling);
+            }
+        } else if (preview.nextSibling !== toolbar) {
+            editor.insertBefore(preview, toolbar);
         }
         titleInput.placeholder=options.labels.titlePlaceholder;
         titleInput.setAttribute('aria-label',options.labels.titlePlaceholder);
@@ -331,6 +336,36 @@
         previewFollowPending=false;
     }
 
+    function captureSourceView() {
+        return {
+            scrollTop: textarea.scrollTop,
+            scrollLeft: textarea.scrollLeft,
+            selectionStart: textarea.selectionStart,
+            selectionEnd: textarea.selectionEnd,
+            selectionDirection: textarea.selectionDirection
+        };
+    }
+
+    function restoreSourceView(view) {
+        if (textarea.selectionStart !== view.selectionStart ||
+            textarea.selectionEnd !== view.selectionEnd ||
+            textarea.selectionDirection !== view.selectionDirection) {
+            textarea.setSelectionRange(
+                view.selectionStart,
+                view.selectionEnd,
+                view.selectionDirection
+            );
+        }
+        // Native value/focus/selection updates may pan the textarea. Restore
+        // this operation's viewport, never a position retained across user input.
+        if (textarea.scrollTop !== view.scrollTop) {
+            textarea.scrollTop = view.scrollTop;
+        }
+        if (textarea.scrollLeft !== view.scrollLeft) {
+            textarea.scrollLeft = view.scrollLeft;
+        }
+    }
+
     function updatePreview(follow=false){
         if(destroyed){
             return;
@@ -340,6 +375,7 @@
         }
         previewFrame=0;
         previewFollowPending=false;
+        const sourceView = captureSourceView();
         const scrollTop=preview.scrollTop;
         const scrollLeft=preview.scrollLeft;
         const markdown=new MD(textarea.value,{sourceMap:options.followPreview});
@@ -355,6 +391,7 @@
         if(follow&&options.followPreview&&options.showPreview){
             followTypingPosition(markdown.sourceMap);
         }
+        restoreSourceView(sourceView);
     }
 
     function followTypingPosition(sourceMap){
@@ -434,6 +471,7 @@
             return;
         }
 
+        const sourceView = captureSourceView();
         const result=applyMarkdownFormat(
             textarea.value,
             textarea.selectionStart,
@@ -441,8 +479,12 @@
             format
         );
         textarea.value=result.value;
-        textarea.focus();
-        textarea.setSelectionRange(result.selectionStart,result.selectionEnd);
+        textarea.focus(
+            {preventScroll: true}
+        );
+        sourceView.selectionStart = result.selectionStart;
+        sourceView.selectionEnd = result.selectionEnd;
+        restoreSourceView(sourceView);
         contentChanged();
     }
 
@@ -524,8 +566,13 @@
             return false;
         }
         supersedeSave('markdown-content-replaced');
-        textarea.value=`${value??''}`;
+        const sourceView = captureSourceView();
+        const nextValue = `${value ?? ''}`;
+        if (textarea.value !== nextValue) {
+            textarea.value = nextValue;
+        }
         updatePreview();
+        restoreSourceView(sourceView);
         return textarea.value;
     }
 

package/runtime/arcane/entities/Chat.js

@@ -433,8 +433,8 @@ class ChatEntity{
     /**
      * Creates a new chat session.
      *
-     * A unique file name is generated automatically using
-     * the current timestamp.
+     * The default file name combines the current timestamp with an
+     * independent random identifier, including across concurrent tabs.
      *
      * Optionally accepts a system prompt which will be added
      * as the first message in the conversation.
@@ -444,7 +444,8 @@ class ChatEntity{
      */
     constructor(systemPrompt=''){
 
-        this.fileName=`chat-${Date.now()}.jsonl`;
+        const identity=globalThis.crypto.getRandomValues(new Uint32Array(4)).join('-');
+        this.fileName=`chat-${Date.now()}-${identity}.jsonl`;
 
         if(systemPrompt){
             this.#messages.push(

package/runtime/arcane/modules/VoiceCaptureWorklet.js

@@ -7,6 +7,9 @@ class ArcaneVoiceCaptureProcessor extends AudioWorkletProcessor {
     #quietFrames;
     #chunkFrames;
     #activityThreshold;
+    #analysisSamples;
+    #analysisCount = 0;
+    #analysisEnergy = 0;
     #active = false;
     #hasActivity = false;
     #quietCount = 0;
@@ -25,6 +28,9 @@ class ArcaneVoiceCaptureProcessor extends AudioWorkletProcessor {
         this.#quietFrames = Math.max(1, Math.round(configuration.quietMs * sampleRate / 1000));
         this.#chunkFrames = Math.max(1, Math.round(configuration.chunkMs * sampleRate / 1000));
         this.#activityThreshold = configuration.activityThreshold;
+        // Measure sustained loudness, not individual peaks. The audio clock
+        // owns this fixed 20 ms window, independently of callback block sizes.
+        this.#analysisSamples = new Float32Array(Math.max(1, Math.round(sampleRate * 0.02)));
         this.port.onmessage = this.#receiveControl.bind(this);
     }
 
@@ -32,6 +38,7 @@ class ArcaneVoiceCaptureProcessor extends AudioWorkletProcessor {
         if (this.#stopped || event.data.type !== 'stop') return;
         this.#stopped = true;
         try {
+            this.#flushAnalysis();
             this.#emit('stop');
             this.#release();
             this.port.postMessage(
@@ -50,15 +57,33 @@ class ArcaneVoiceCaptureProcessor extends AudioWorkletProcessor {
         const samples = inputs[0]?.[0];
         if (!samples) return true;
         try {
-            for (const sample of samples) this.#capture(sample);
+            for (const sample of samples) {
+                this.#analysisSamples[this.#analysisCount] = sample;
+                this.#analysisCount += 1;
+                this.#analysisEnergy += sample * sample;
+                if (this.#analysisCount === this.#analysisSamples.length) {
+                    this.#flushAnalysis();
+                }
+            }
         } catch (error) {
             this.#fail(error);
         }
         return !this.#stopped;
     }
 
-    #capture(sample) {
-        const activity = Math.abs(sample) > this.#activityThreshold;
+    #flushAnalysis() {
+        if (!this.#analysisCount) return;
+        const activity = Math.sqrt(this.#analysisEnergy / this.#analysisCount) > this.#activityThreshold;
+        // Classification selects boundaries only. Every original sample still
+        // enters capture in order, including a partial final analysis window.
+        for (let index = 0; index < this.#analysisCount; index += 1) {
+            this.#capture(this.#analysisSamples[index], activity);
+        }
+        this.#analysisCount = 0;
+        this.#analysisEnergy = 0;
+    }
+
+    #capture(sample, activity) {
         if (!this.#active) {
             if (!activity) {
                 this.#retainPreRoll(sample);
@@ -185,6 +210,9 @@ class ArcaneVoiceCaptureProcessor extends AudioWorkletProcessor {
         this.#view = null;
         this.#preRoll = new Float32Array(0);
         this.#preRollLength = 0;
+        this.#analysisSamples = new Float32Array(0);
+        this.#analysisCount = 0;
+        this.#analysisEnergy = 0;
         this.#sampleCount = 0;
         this.#hasActivity = false;
         this.#active = false;