arcane-os 0.34.2 → 0.36.0

package/docs/reference/runtime-modules.md

@@ -72,6 +72,7 @@ own asynchronous work, cancellation, and backpressure.
 | [`CommunicationProviderRegistry.js`](#communicationproviderregistryjs) | esm | Registers and queries validated provider definitions, channels, and required methods. | Cross-host | Strict normalized registry. |
 | [`ComponentContracts.js`](#componentcontractsjs) | esm | Owns normalized configuration/value contracts and shared explicit STT activation behavior for chart, dashboard, Markdown, and voice components. | Cross-host | Fully normalized labels, rows, definitions, visibility, formats, editor and voice options, plus capability-neutral STT activation intent and presentation state. Complete finite progress measures remain visible, including fractional and over-total values. |
 | [`ConfiguredAIChatSession.js`](#configuredaichatsessionjs) | esm | Owns ordinary visible recurring AI turns, one active structural continuation, context construction, provider-response preservation, and atomic history commit. | Native bridge by default; cross-host with injected chat | Normalized session/result; provider rejection preserved. |
+| [`ContinuousVoiceCapture.js`](#continuousvoicecapturejs) | esm | Owns continuous microphone capture with pre-roll, pause/periodic WAV segments, final flush, and cancellation. | Browser / native WebView with AudioWorklet | Complete ordered clips; audio activity and timing are normalized, microphone availability remains browser-owned. |
 | [`ConversationActionItems.js`](#conversationactionitemsjs) | esm | Normalizes, creates, updates, remembers, selects, and formats complete conversation action items. | Cross-host | Fully normalized status/base/presentation contract. |
 | [`ConversationClosingReport.js`](#conversationclosingreportjs) | esm | Defines the closing-report tool, instruction, result normalizer, call classifier, and formatter. | Cross-host | Fully normalized report contract. |
 | [`ConversationTimebox.js`](#conversationtimeboxjs) | esm | Owns conversation limits, control messages, submission barriers, elapsed formatting, and delivery proof. | Cross-host | Fully normalized state/command/delivery errors. |
@@ -131,6 +132,7 @@ own asynchronous work, cancellation, and backpressure.
 | [`uPlot.iife.min.js`](#uplotiifeminjs) | classic-script | Vendored uPlot chart constructor and rendering runtime. | Browser vendor script | Vendor-native. |
 | [`uPlot.LICENSE.txt`](#uplotlicensetxt) | license | License companion for the bundled uPlot vendor runtime. | Documentation asset | Not executable. |
 | [`uPlot.min.css`](#uplotmincss) | stylesheet | Bundled uPlot presentation stylesheet. | Browser stylesheet | Presentation only. |
+| [`VoiceCaptureWorklet.js`](#voicecaptureworkletjs) | worker | Segments and encodes continuous microphone audio on the audio rendering thread. | AudioWorkletGlobalScope | Rolling pre-roll, activity/quiet/periodic boundaries, complete WAV clips, and final stop acknowledgement. |
 | [`WaitForComponent.js`](#waitforcomponentjs) | esm | Waits for a component property, method, or readiness event with optional error event and bounded timeout. | Cross-host EventTarget / browser component | Normalized coded readiness, error, and timeout results. |
 | [`YouTubeMedia.js`](#youtubemediajs) | esm | Parses YouTube video/playlist locators and constructs ordinary embed URLs with opt-in privacy enhancement. | Cross-host | Fully normalized mutable locators. |
 
@@ -1637,7 +1639,15 @@ behavior for chart, dashboard, Markdown, and voice components.
 ### Public surface
 
 Constant sets plus normalization, formatting, and explicit STT activation
-helpers. `createSTTActivationController({host,button,progress=null,onChange,EventClass=CustomEvent})`
+helpers. `normalizeVoiceOptions(input,previous)` keeps `capture.mode:'manual'`
+and `controls:'standard'` as defaults. Continuous capture accepts
+`{mode:'continuous',preRollMs:1500,quietMs:2000,chunkMs:30000,activityThreshold:0.02}`;
+`controls:'simple'`, `showComplete`, and the `retry`/`cancel` labels configure
+the shared voice component. Positive quiet/chunk durations and nonnegative
+pre-roll/activity values must be finite. Complete callback payloads remain
+owned by the component and application.
+
+`createSTTActivationController({host,button,progress=null,onChange,EventClass=CustomEvent})`
 consumes only normalized
 [`AIRuntimeState`](#airuntimestatejs) `stt` role records. Its mutable controller
 exposes `action`, `error`, `label`, `pending`, `selected`, `status`, `title`, and
@@ -1797,6 +1807,76 @@ const session = new ConfiguredAIChatSession({
 console.log(await session.send('Hello'));
 ```
 
+## ContinuousVoiceCapture.js
+
+### Overview
+
+Owns a continuous microphone session whose audio worklet keeps rolling
+pre-roll and produces complete clips at quiet or periodic boundaries. The
+capture owner has no model, transcription, persistence, or application policy.
+The shared [`voice-transcription.html`](runtime-components.md#voice-transcriptionhtml)
+component adds ordered STT, persistence, retry, and presentation.
+
+### Public surface
+
+Default export `ContinuousVoiceCapture` accepts
+`{preRollMs=1500,quietMs=2000,chunkMs=30000,activityThreshold=0.02,onSegment,onError,onState}`.
+`start({mediaConstraints={audio:true},signal}={})` acquires microphone input and
+resolves `true` once capture starts, or `false` after cancellation or a
+reported start failure. Starting capture is an explicit caller action.
+
+`onSegment({audio,sequence,reason,durationMs})` receives a complete
+`audio/wav` Blob containing mono Float32 audio. Sequence starts at one for
+each capture session; reason is `pause`, `periodic`, or `stop`. The detector
+uses amplitude to find activity, including noise; it does not determine
+whether a person is speaking. Inactive windows produce no clips. Pre-roll is
+used once when activity starts, and periodic segments remain adjacent without
+repeated samples. Pre-roll longer than `chunkMs` remains complete in the first
+active clip, so that clip may exceed the periodic duration.
+
+`stop()` releases microphone tracks immediately and returns a promise that
+settles after the worklet flushes the final active clip and acknowledges stop.
+Capture cancellation while microphone permission or worklet loading is
+pending releases late-acquired resources. `cancel()` and `destroy()` discard
+pending capture and suppress late segment delivery. They do not cancel
+application work that already accepted a segment; its owner supplies that
+cancellation boundary. The optional signal cancels this capture session.
+
+`onState` reports `starting`, `listening`, `stopped`, or `interrupted`;
+`onError` receives the original capture error. A naturally ended microphone
+flushes the active clip before reporting interruption while the worklet remains
+available. A failed audio context or processor reports interruption directly;
+audio still inside an unavailable processor cannot be recovered. Callback
+promises are observed without delaying capture or stop acknowledgement.
+Capture state is independent
+of model readiness, STT processing, and application save state.
+
+### Availability and normalization
+
+**Browser / supported native WebView.** Requires browser microphone access,
+`AudioContext`, and `AudioWorklet`. Browser secure-context and permission rules
+apply at those platform APIs. The static sibling
+[`VoiceCaptureWorklet.js`](#voicecaptureworkletjs) owns sample processing and
+WAV encoding on the audio rendering thread. No audio model or third-party
+capture runtime is loaded. Native hosts use the same browser APIs where
+available, with no Core service selected implicitly.
+
+### Example
+
+```javascript
+import ContinuousVoiceCapture from '/arcane/modules/ContinuousVoiceCapture.js';
+
+const capture=new ContinuousVoiceCapture({
+    onSegment:queueTranscription,
+    onError:showCaptureError,
+    onState:showCaptureState
+});
+// Call from the application's explicit recording action.
+await capture.start();
+// The application's stop action waits for the final clip.
+await capture.stop();
+```
+
 ## ConversationActionItems.js
 
 ### Overview
@@ -1986,6 +2066,39 @@ default `DBOPFS`; installs `window.dbopfs`, emits `dbopfs-ready`; table/file/bac
 
 Exact exports: `DBOPFS_EVENT_TYPES`, `DBOPFS_REASONS`, `default`.
 
+`createCompressedPNG({tableNames, additionalTables, signal})` returns an
+`image/png` Blob without downloading or writing records. Omitted `tableNames`
+selects all discovered saved tables; `[]` selects none. Named absent tables
+are encoded as empty tables without creating OPFS directories. The existing
+`memories`/`memory` alias is retained. `additionalTables` is an application-owned
+`{tableName:{fileName:value}}` map. Each supplied table replaces the matching
+saved table in this export only, rather than inheriting records the caller did
+not select. Values retain the existing JSON serialization contract. Applications
+own recipient policy, profile projections, and any product format marker.
+
+`downloadCompressedPNG(name, options)` uses that same method and its options,
+then initiates one timestamp-named download. Existing `downloadCompressedPNG(name)`
+calls retain full-database behavior. An optional `AbortSignal` stops further
+record preparation and prevents a later download. File reads and browser canvas
+encoding already in progress cannot be interrupted; their result is discarded
+on cancellation. No object URL or download is created by `createCompressedPNG`.
+
+`restoreFromPNG(file, {selectTables})` preserves the existing deflate/RGB backup format and
+restores through `setMany()` without changing its settled-result API or per-key
+write ordering. The optional callback receives the complete decoded table/file
+map exactly once and may return a map or promise of a map. Only its returned
+tables and records are written, allowing application-owned selection and
+projection of older full backups without a second decoder or temporary storage
+writes. Callback failure rejects before any writes. With no callback, all
+decoded tables are restored as before.
+
+Restore resolves only when every selected record write succeeds. It
+continues the table batches after individual rejected writes, then rejects an
+`AggregateError` with code `DBOPFS_RESTORE_WRITE_FAILED`, original reasons in
+`errors`, and `failures` entries `{tableName, fileName, reason}`. Successful
+writes remain saved; restore is not an all-or-nothing transaction. The decoded
+image is closed after pixel extraction, including canvas failures.
+
 ### Availability and normalization
 
 **Browser / native WebView.** App scope and recognized JSON/JSONL file parsing
@@ -3761,6 +3874,34 @@ Load with a stylesheet link before rendering uPlot charts.
 <link rel="stylesheet" href="/arcane/modules/uPlot.min.css">
 ```
 
+## VoiceCaptureWorklet.js
+
+### Overview
+
+Internal audio processor for [`ContinuousVoiceCapture.js`](#continuousvoicecapturejs).
+It keeps rolling pre-roll, detects audio amplitude, 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.
+
+### Public surface
+
+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`.
+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,
+sample-count, and data framing. Quiet-only capture emits no segments, and
+periodic segments never repeat samples.
+
+### Availability and normalization
+
+**AudioWorkletGlobalScope only.** This is an owner-local native MessagePort
+protocol, with no separate event bus, model request, or persistence. Applications
+use `ContinuousVoiceCapture` or the shared voice component rather than importing
+this processor in a document or Worker.
+
 ## WaitForComponent.js
 
 ### Overview

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.34.2",
+  "version": "0.36.0",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -86,7 +86,7 @@
     "test": "npm run test:unit && npm run test:functional && npm run test:integration && npm run test:regression",
     "test:release": "node ./bin/arcane-test.mjs test/npm-release.test.mjs",
     "test:unit": "node ./bin/arcane-test.mjs test/app-descriptor.test.mjs test/app-schema.test.mjs test/app-selection.test.mjs test/contracts.test.mjs test/doctor.test.mjs test/mail-credentials.test.mjs test/mail-outbox.test.mjs test/mail-public-api.test.mjs test/mail-send.test.mjs test/mail-transport.test.mjs test/targets.test.mjs test/workspace-operation-lock.test.mjs",
-    "test:functional": "node ./bin/arcane-test.mjs test/ai-request-model.test.mjs test/ai-request-retry.test.mjs test/ai-stream-cancellation.test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/chat-stream-speech.test.mjs test/chat-transcript-scroll.test.mjs test/chat-transient-retention.test.mjs test/cli.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/modal.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/twin-cloud.test.mjs test/update-check.test.mjs test/user-explicit-updates.test.mjs",
+    "test:functional": "node ./bin/arcane-test.mjs test/ai-request-model.test.mjs test/ai-request-retry.test.mjs test/ai-stream-cancellation.test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/chat-stream-speech.test.mjs test/chat-transcript-scroll.test.mjs test/chat-transient-retention.test.mjs test/cli.test.mjs test/continuous-voice-capture.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs-png.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/file-preview.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/modal.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/twin-cloud.test.mjs test/update-check.test.mjs test/user-explicit-updates.test.mjs",
     "test:integration": "node ./bin/arcane-test.mjs test/installed-package-runtime.test.mjs test/root-app-layout.test.mjs test/integrated-shared.test.mjs test/integrated-workspace.test.mjs test/mail-browser.test.mjs test/native-plan.test.mjs test/native-provider-loader.test.mjs test/npm-release.test.mjs test/release-bundle.test.mjs test/release-capability-smoke.test.mjs test/shared-payload-batch.test.mjs test/tarball.test.mjs test/browser-wasm-cpu.test.mjs test/wllama-webgpu-runtime.test.mjs",
     "test:regression": "node ./bin/arcane-test.mjs test/channel-workflows.test.mjs test/html-import-registration.test.mjs test/logging-regression.test.mjs test/markdown-speech.test.mjs test/prepared-speech.test.mjs test/native-provider-generation.test.mjs test/speech-queue-regression.test.mjs test/testing.test.mjs test/test-sets.test.mjs",
     "check": "node tools/check-source.mjs && npm test",

package/runtime/arcane/components/data-view.html

@@ -85,12 +85,12 @@
 
             heading.innerText=host.dataset.title||'Data';
             fileManager.className='file-manager';
-            fileManager.previewTransform=host.previewTransform;
+            forwardPreviewOptions();
             fileManager.dataset.dirs=host.dataset.dirs||'';
             fileManager.dataset.layout=host.dataset.layout||'files';
             fileManager.setAttribute(
                 'href',
-                new URL('./file-manager.html?v=18',componentHref).href
+                new URL('./file-manager.html?v=19',componentHref).href
             );
 
             content.append(heading,fileManager);
@@ -100,6 +100,10 @@
             }
         }
 
+        if(reload){
+            forwardPreviewOptions();
+        }
+
         const manager=await waitForComponent(
             fileManager,
             {
@@ -124,6 +128,18 @@
         return true;
     }
 
+    function forwardPreviewOptions(){
+        fileManager.previewTransform=host.previewTransform;
+        fileManager.previewDescriptor=host.previewDescriptor;
+        fileManager.directoryFilter=host.directoryFilter;
+        if(host.dataset.hiddenPrefixes===undefined){
+            delete fileManager.dataset.hiddenPrefixes;
+        }else{
+            fileManager.dataset.hiddenPrefixes=host.dataset.hiddenPrefixes;
+        }
+        fileManager.toggleAttribute('data-show-hidden',host.hasAttribute('data-show-hidden'));
+    }
+
     function destroy(){
         if(destroyed){
             return false;