arcane-os 0.2.2 → 0.3.0

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

@@ -3,9 +3,9 @@
   "source": {
     "authority": "sdk-canonical",
     "repository": "https://github.com/TheWizardNexus/arcane-os-sdk.git",
-    "commit": "36fbe1418af3d5c343d105ee7c9456360c57785d",
+    "commit": "75b01e7ddcd751f7970d8c1aaf18bfff05b706b7",
     "path": "runtime/arcane/components",
-    "sdkVersion": "0.2.1",
+    "sdkVersion": "0.3.0",
     "legacyProjection": {
       "repository": "https://github.com/TheWizardNexus/ARCANE-OS.git",
       "commit": "c540014afe69f14cf5ae60493b7295f36dbcec64",
@@ -23,7 +23,8 @@
         "setNavigation()",
         "setActiveRoute()",
         "setStatus()",
-        "refresh()"
+        "refresh()",
+        "destroy()"
       ],
       "events": [
         "app-bar-ready"
@@ -52,10 +53,13 @@
         "clear()",
         "setState()",
         "focusComposer()",
-        "scrollToEnd()"
+        "scrollToEnd()",
+        "destroy()"
       ],
       "events": [
         "assistant-ready",
+        "assistant-opened",
+        "assistant-closed",
         "assistant-send",
         "assistant-clear"
       ],
@@ -82,7 +86,8 @@
       "name": "calculator.html",
       "purpose": "Calculator keypad and result/error event surface backed by CalculatorEngine.",
       "methods": [
-        "calculate()"
+        "calculate()",
+        "destroy()"
       ],
       "events": [
         "calculator-ready",
@@ -144,9 +149,12 @@
         "chat-send-message",
         "chat-send-error",
         "chat-file-uploaded",
+        "chat-file-upload-error",
         "chat-language-changed",
+        "chat-language-change-error",
         "chat-ai-activation-request",
         "chat-ai-activation-error",
+        "chat-speech-synthesis-error",
         "conversation-timebox-error"
       ],
       "slots": [],
@@ -168,7 +176,8 @@
         "setConversation()",
         "setBusy()",
         "setStatus()",
-        "clearComposer()"
+        "clearComposer()",
+        "destroy()"
       ],
       "events": [
         "conversation-view-ready",
@@ -192,7 +201,8 @@
         "getChartOptions()",
         "getEffectiveVisibility()",
         "open()",
-        "close()"
+        "close()",
+        "destroy()"
       ],
       "events": [
         "dashboard-config-ready",
@@ -214,7 +224,8 @@
       "name": "data-maintenance.html",
       "purpose": "Runs destructive cleanup of empty chats and memories inside the current app data scope.",
       "methods": [
-        "open()"
+        "open()",
+        "destroy()"
       ],
       "events": [
         "data-maintenance-ready",
@@ -235,7 +246,8 @@
       "purpose": "Opens a generic modal-style data view around an injected provider.",
       "methods": [
         "beforeOpen()",
-        "open()"
+        "open()",
+        "destroy()"
       ],
       "events": [
         "data-view-ready"
@@ -255,7 +267,8 @@
       "methods": [
         "configure()",
         "focus()",
-        "select()"
+        "select()",
+        "destroy()"
       ],
       "events": [
         "directory-picker-ready",
@@ -278,7 +291,8 @@
       "methods": [
         "loadDocument()",
         "selectView()",
-        "markSaved()"
+        "markSaved()",
+        "destroy()"
       ],
       "events": [
         "document-inspector-ready",
@@ -302,7 +316,8 @@
         "clear()",
         "setBusy()",
         "setError()",
-        "setProgress()"
+        "setProgress()",
+        "destroy()"
       ],
       "events": [
         "file-drop-ready",
@@ -328,7 +343,8 @@
         "setActions()",
         "setBusy()",
         "setError()",
-        "setPreview()"
+        "setPreview()",
+        "destroy()"
       ],
       "events": [
         "file-inspector-ready",
@@ -357,7 +373,8 @@
         "loadAll()",
         "setFilter()",
         "select()",
-        "clearSelection()"
+        "clearSelection()",
+        "destroy()"
       ],
       "events": [
         "file-manager-ready",
@@ -394,7 +411,8 @@
       "methods": [
         "configure()",
         "getValues()",
-        "setStatus()"
+        "setStatus()",
+        "destroy()"
       ],
       "events": [
         "integration-settings-ready",
@@ -415,7 +433,9 @@
       "methods": [
         "configure()",
         "begin()",
-        "present(); hidden property"
+        "present()",
+        "destroy()",
+        "hidden property"
       ],
       "events": [
         "local-ai-status-ready",
@@ -441,11 +461,16 @@
         "clear()",
         "fail()",
         "focus()",
-        "focusFragment()"
+        "focusFragment()",
+        "destroy()"
       ],
       "events": [
         "markdown-document-ready",
         "markdown-document-state",
+        "markdown-document-loading",
+        "markdown-document-rendered",
+        "markdown-document-empty",
+        "markdown-document-error",
         "markdown-document-navigate"
       ],
       "slots": [],
@@ -464,7 +489,8 @@
         "configure()",
         "focus()",
         "clear()",
-        "saveEntry()"
+        "saveEntry()",
+        "destroy()"
       ],
       "events": [
         "markdown-editor-ready",
@@ -486,7 +512,8 @@
       "purpose": "Loads a validated YouTube video or playlist embed and exposes external-platform action.",
       "methods": [
         "configure()",
-        "load()"
+        "load()",
+        "destroy()"
       ],
       "events": [
         "media-embed-ready",
@@ -510,7 +537,8 @@
         "populate()",
         "open()",
         "close()",
-        "runTasks()"
+        "runTasks()",
+        "destroy()"
       ],
       "events": [
         "modal-ready",
@@ -541,7 +569,8 @@
         "setPending()",
         "setStatus()",
         "setError()",
-        "clear()"
+        "clear()",
+        "destroy()"
       ],
       "events": [
         "output-panel-ready",
@@ -572,7 +601,8 @@
         "getValues()",
         "setValues()",
         "setBusy()",
-        "setStatus()"
+        "setStatus()",
+        "destroy()"
       ],
       "events": [
         "preferences-form-ready",
@@ -592,7 +622,8 @@
       "purpose": "Displays chronological records/evidence and emits open actions.",
       "methods": [
         "setItems()",
-        "populate()"
+        "populate()",
+        "destroy()"
       ],
       "events": [
         "record-timeline-ready",
@@ -610,7 +641,8 @@
       "purpose": "Displays normalized relationship nodes/edges in graph and list forms.",
       "methods": [
         "setGraph()",
-        "populate()"
+        "populate()",
+        "destroy()"
       ],
       "events": [
         "relationship-board-ready",
@@ -628,7 +660,8 @@
       "name": "screen-capture.html",
       "purpose": "Presents image, video, or GIF display-capture workflow.",
       "methods": [
-        "capture()"
+        "capture property (ScreenCapture instance)",
+        "destroy()"
       ],
       "events": [
         "screen-capture-ready",
@@ -653,11 +686,16 @@
         "clear()",
         "fail()",
         "focus()",
-        "focusLine()"
+        "focusLine()",
+        "destroy()"
       ],
       "events": [
         "source-code-viewer-ready",
-        "source-code-viewer-state"
+        "source-code-viewer-state",
+        "source-code-viewer-state-loading",
+        "source-code-viewer-state-ready",
+        "source-code-viewer-state-empty",
+        "source-code-viewer-state-error"
       ],
       "slots": [],
       "dependencies": [],
@@ -673,7 +711,8 @@
         "showFinding()",
         "populate()",
         "selectSource()",
-        "markSaved()"
+        "markSaved()",
+        "destroy()"
       ],
       "events": [
         "source-explanation-ready",
@@ -689,28 +728,40 @@
     {
       "file": "runtime/arcane/components/speech.html",
       "name": "speech.html",
-      "purpose": "Coordinates speech controls, transcription completion, mute state, and microphone availability.",
+      "purpose": "Coordinates explicit speech-to-text activation, request cancellation, speech controls, transcription completion, mute state, and microphone availability.",
       "methods": [
         "configure()",
         "setAvailability()",
-        "setMuted(); availability",
+        "setMuted()",
+        "reportTTSError()",
+        "requestSTTActivation()",
+        "destroy()",
+        "availability",
         "muted",
         "initialMuted",
-        "componentReady properties"
+        "componentReady"
       ],
       "events": [
         "speech-ready",
         "speech-transcription-complete",
-        "speech-microphone-unavailable"
+        "speech-transcription-error",
+        "speech-transcription-cancelled",
+        "speech-microphone-unavailable",
+        "speech-stt-activation-request",
+        "speech-stt-activation-error",
+        "speech-tts-lifecycle-error",
+        "speech-synthesis-error"
       ],
       "slots": [],
       "dependencies": [
         "AI.js",
+        "AIRuntimeState.js",
+        "ComponentContracts.js",
         "DBLS.js"
       ],
       "availability": "Browser and supported native WebViews",
       "transport": "HTMLImport + DOM; injected Arcane/provider modules where listed",
-      "normalization": "UI state normalized; AI/media behavior mixed"
+      "normalization": "UI/runtime state, explicit STT activation intent, and request-owned cancellation are normalized; positive compatibility booleans cannot manufacture provider readiness; provider/model authority and media behavior remain external"
     },
     {
       "file": "runtime/arcane/components/summary-strip.html",
@@ -720,7 +771,8 @@
         "configure()",
         "setItems()",
         "updateItem()",
-        "clear()"
+        "clear()",
+        "destroy()"
       ],
       "events": [
         "summary-strip-ready",
@@ -739,7 +791,8 @@
       "purpose": "Builds and updates a simple header/body table.",
       "methods": [
         "buildHeader()",
-        "buildTable()"
+        "buildTable()",
+        "destroy()"
       ],
       "events": [
         "table-ready",
@@ -761,7 +814,8 @@
         "setTasks()",
         "updateTask()",
         "runTasks()",
-        "clear()"
+        "clear()",
+        "destroy()"
       ],
       "events": [
         "task-progress-ready",
@@ -789,7 +843,8 @@
         "clear()",
         "setState()",
         "setTheme()",
-        "focus()"
+        "focus()",
+        "destroy()"
       ],
       "events": [
         "terminal-workspace-ready",
@@ -818,7 +873,8 @@
         "getTheme()",
         "setTheme()",
         "setBusy()",
-        "setStatus()"
+        "setStatus()",
+        "destroy()"
       ],
       "events": [
         "theme-editor-ready",
@@ -859,7 +915,8 @@
         "configure()",
         "setThreads()",
         "setActive()",
-        "setLoading()"
+        "setLoading()",
+        "destroy()"
       ],
       "events": [
         "unified-inbox-ready",
@@ -875,9 +932,10 @@
     {
       "file": "runtime/arcane/components/voice-transcription.html",
       "name": "voice-transcription.html",
-      "purpose": "Records segmented microphone audio, transcribes, persists, and completes a combined transcript.",
+      "purpose": "Records segmented microphone audio only after authoritative STT admission, exposes explicit selected-STT activation, transcribes with cancellation, persists, and completes a combined transcript.",
       "methods": [
         "configure()",
+        "requestSTTActivation()",
         "startRecording()",
         "stopRecording()",
         "save()",
@@ -892,17 +950,21 @@
         "voice-transcription-segment",
         "voice-transcription-change",
         "voice-transcription-complete",
-        "speech-transcription-complete"
+        "speech-transcription-complete",
+        "speech-transcription-cancelled",
+        "speech-stt-activation-request",
+        "speech-stt-activation-error"
       ],
       "slots": [],
       "dependencies": [
         "MD.js",
         "ComponentContracts.js",
+        "AIRuntimeState.js",
         "AI.js"
       ],
       "availability": "Browser and supported native WebViews",
       "transport": "HTMLImport + DOM; injected Arcane/provider modules where listed",
-      "normalization": "State/text normalized; media/provider behavior mixed"
+      "normalization": "Sticky runtime STT readiness, explicit activation, request cancellation, and state/text are normalized; media/provider behavior remains external"
     },
     {
       "file": "runtime/arcane/components/weather-widget.html",
@@ -910,7 +972,8 @@
       "purpose": "Displays normalized current and daily weather with refresh intent.",
       "methods": [
         "setWeather()",
-        "clear()"
+        "clear()",
+        "destroy()"
       ],
       "events": [
         "weather-widget-ready",
@@ -929,7 +992,8 @@
       "methods": [
         "configure()",
         "navigate()",
-        "currentUrl()"
+        "currentUrl()",
+        "destroy()"
       ],
       "events": [
         "web-navigator-ready",