arcane-os 0.86.0 → 0.86.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.86.1
+
+- Include the existing public `arcane-os/ai/model-observation` export in
+  generated browser import maps. Both managed application maps and standalone
+  document maps resolve the same published browser module, including direct
+  installed-package URLs and nested documents.
+- Consumers adopt the published package and run their normal import-map
+  generation before rebuilding or serving their application. No manual map
+  edits, alternate imports or new native host build are required. The matching
+  Windows and Whisper runtime assets are unchanged from 0.86.0.
+
 ## 0.86.0
 
 - Add fixed `Tab`, `Shift+Tab`, `Enter` and `Space` key operations to

package/README.md

@@ -25,7 +25,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.86.0` SDK contract. Development applications declare
+This checkout defines the `0.86.1` 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/inventory/package-api.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "sdkVersion": "0.85.0",
+  "sdkVersion": "0.86.0",
   "environment": {
     "runtime": "Node.js for Node entrypoints; browser for browser-only entrypoints",
     "minimumVersion": "22.23.2 for Node entrypoints",
@@ -63,10 +63,10 @@
       "entrypoints": ["arcane-os/core/app-control"],
       "primaryImport": "arcane-os/core/app-control",
       "group": "Native application control",
-      "summary": "Connects to one explicit running native window for background document inspection, viewport capture and targeted DOM actions.",
+      "summary": "Connects to one explicit running native window for background document inspection, viewport capture, targeted DOM actions, fixed keys and Normal-window client resizing.",
       "availability": "Node local IPC on Windows, Linux and macOS; the current window adapter is Windows WebView2, with other native adapters unavailable",
-      "protocol": "arcane/1 app.control.status, app.control.inspect, app.control.capture and app.control.act over the existing framed local connection. The window host selects native.launchContext.appControl.endpoint and preserves its existing Core child, origin, profile and lifetime.",
-      "normalization": "Returns endpoint, closed, status(options), inspect(parameters={},options), capture(parameters={},options), act(parameters,options), and close(). Parameters pass unchanged; per-operation options preserve Core signal/timeout behavior. Status reports actual app/window/document readiness. Inspect returns complete selected DOM HTML/text and live control state with DOM-derived role/name hints. Optional shadowPath on inspect and act is an ordered array of unique CSS host selectors through open shadow roots; selector resolves in the final root, with omitted/empty paths retaining top-level light DOM. Whole-shadow-root inspection returns complete innerHTML/textContent with null selector/state; nested shadow-host descriptors provide their full path. Frames remain descriptors and closed roots are unavailable. Capture returns mimeType image/png, complete base64 data, documentGeneration and URL for the rendered viewport. Act requires documentGeneration and one CSS selector with click, exact-string fill, exact-value select or absolute-offset scroll. The native document marker prevents queued actions crossing replacement; cancellation before dispatch prevents execution while dispatched work is observed through completion without retry or reversal. close() cancels only this connection, never the application or Core. No launch, automatic reconnect, desktop activation, global input or public arbitrary evaluator. CLI inspection accepts either --selector or a complete --request JSON object. See native-app-control.md for complete result fields, CLI and platform scope."
+      "protocol": "arcane/1 app.control.status, app.control.inspect, app.control.capture, app.control.act, app.control.key and app.control.resize over the existing framed local connection. The window host selects native.launchContext.appControl.endpoint and preserves its existing Core child, origin, profile and lifetime; assembly requires a matching published Windows host asset.",
+      "normalization": "Returns endpoint, closed, status(options), inspect(parameters={},options), capture(parameters={},options), act(parameters,options), key(parameters,options), resize(parameters,options), and close(). Parameters pass unchanged; per-operation options preserve Core signal/timeout behavior. Status reports actual app/window/document readiness. Inspect returns complete selected DOM HTML/text and live control state with DOM-derived role/name hints, plus top-level viewport CSS dimensions/devicePixelRatio, documentHasFocus and focusPath through the active open-shadow branch; focus records are observations with null selectors, separate from the selected root's activeElement. Optional shadowPath on inspect and act is an ordered array of unique CSS host selectors through open shadow roots; selector resolves in the final root, with omitted/empty paths retaining top-level light DOM. Whole-shadow-root inspection returns complete innerHTML/textContent with null selector/state; nested shadow-host descriptors provide their full path. Frames remain descriptors and closed roots are unavailable. Capture returns mimeType image/png, complete base64 data, documentGeneration and URL for the rendered viewport. Act requires documentGeneration and one CSS selector with click, exact-string fill, exact-value select or absolute-offset scroll. Key requires documentGeneration and Tab, Enter or Space; shiftKey:true is supported only for Tab. One keyboard owner keeps each press/release pair ordered at the selected WebView's current focus. An attempted press owns a matching release even after cancellation, navigation or failure; no failed or ambiguous press is replayed. Generation checks bracket native input without atomic document binding. Resize accepts positive integral native client width/height supported by WinForms and optional documentGeneration, changes only a Normal window's ClientSize, and returns immediate previous/actual native dimensions plus the later observed CSS viewport. Native and CSS snapshots are not atomic; platform constraints may change actual dimensions. Restoration is an explicit resize using the operation's previous native dimensions; unsupported window states fail before mutation. The native document marker prevents queued DOM actions crossing replacement; cancellation before dispatch prevents execution while dispatched work is observed through completion without retry or reversal, including owned key release. Partial results remain in actual errors and complete later responses remain in host diagnostics after cancellation or disconnection. Dispatch completion does not establish application handler completion or a successful business action. close() cancels only this connection, never the application or Core. No launch, automatic reconnect, desktop activation, global input or public arbitrary evaluator. CLI inspection accepts either --selector or a complete --request JSON object; act, key and resize forward their complete --request parameter objects. See native-app-control.md for complete result fields, CLI and platform scope."
     },
     {
       "id": "local-ai-execution-devices:createExecutionDeviceCatalog",

package/docs/reference/sdk-api.md

@@ -9076,7 +9076,7 @@ connectAppControl({endpoint,signal,onError}={})
 ```
 
 Connects once to the explicit running native window and resolves
-`{endpoint,closed,status,inspect,capture,act,close}`. The Windows host selects its
+`{endpoint,closed,status,inspect,capture,act,key,resize,close}`. The Windows host selects its
 own listener through `native.launchContext.appControl.endpoint` and preserves the
 existing Core child, origin, profile and application lifetime. The client uses
 portable Node local IPC; other native host adapters do not yet implement these
@@ -9088,14 +9088,49 @@ and no automatic reconnect or action retry occurs.
 and live control state. Inspection and actions accept optional `shadowPath`, an
 ordered array of unique CSS host selectors through open shadow roots; their
 `selector` resolves inside the final root. Omission retains top-level light DOM.
-Closed roots remain unavailable. `capture(parameters={},options)` returns a full base64 PNG
+Closed roots remain unavailable. Inspection also returns top-level `viewport`
+CSS-pixel width/height and `devicePixelRatio`, `documentHasFocus`, and `focusPath`
+through the active open-shadow branch. These focus records have null selectors
+and remain separate from the selected root's `activeElement`; frames and closed
+roots end the path. `capture(parameters={},options)` returns a full base64 PNG
 of the rendered viewport. `act(parameters,options)` requires a returned
 `documentGeneration`, one CSS selector, and `click`, `fill`, `select` or `scroll`
-fields. Options preserve the Core client signal/timeout contract. `close()`
-cancels this connection's requests and returns `closed`, without closing the app.
-Document changes and actual errors remain observable; a dispatched action is
-not reversed by later cancellation. Full parameter/result, CLI and platform
-contracts are in [native application control](native-app-control.md).
+fields.
+
+`key(parameters,options)` requires the observed `documentGeneration` and
+`key:'Tab'`, `'Enter'` or `'Space'`; `shiftKey:true` is supported only for Tab.
+It sends a fixed ordered press/release pair to the selected WebView's current
+focus, without selecting an element or activating the desktop window. Accepted
+pairs share one keyboard owner. Once a press is attempted, its matching release
+is attempted on the same WebView even after cancellation, navigation or failure;
+a failed or ambiguous press is never replayed. Results retain previous/actual
+document views and complete attempted/completed phase records. Generation checks
+bracket native input rather than atomically binding it to a document, so focus
+or navigation can change between phases.
+
+`resize(parameters,options)` accepts positive integral native client `width`
+and `height` supported by WinForms, plus optional `documentGeneration`. It changes
+only `ClientSize` while the actual window is `Normal`; maximized or minimized
+windows fail before size mutation. Results retain immediate `previous`/`actual`
+native dimensions, requested dimensions, attempted/completed flags and a later
+observed CSS `viewport`. Platform constraints can change actual dimensions;
+native and CSS observations are not an atomic snapshot. Restore explicitly with
+the same operation's `previous.width` and `previous.height`, not CSS dimensions
+or a historical status snapshot. Cancellation does not restore the window.
+
+Options preserve the Core client signal/timeout contract. Cancellation before
+dispatch prevents execution; dispatched work and owned key release remain
+observed through completion. Actual errors retain complete partial results;
+responses completed after cancellation or disconnection remain in host
+diagnostics. `close()` cancels this connection's requests and returns `closed`,
+without closing the app. Document changes and actual errors remain observable.
+Dispatch completion does not establish application handler completion or a
+successful business action; inspect the resulting built application to establish
+that outcome. Assembly requires a matching published Windows host asset.
+
+The CLI provides `app-control key` and `app-control resize`, each forwarding the
+complete parsed `--request` object. Full parameter/result, error, cancellation,
+CLI and platform contracts are in [native application control](native-app-control.md).
 
 ## runSharedCoreHost()
 

package/package.json

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

package/src/import-map.mjs

@@ -53,6 +53,7 @@ const SDK_BROWSER_SELF_IMPORTS=new Map([
     ['arcane-os/ai/core-onnx','sdk/ai/core-onnx.mjs'],
     ['arcane-os/ai/core-image','sdk/ai/core-image.mjs'],
     ['arcane-os/ai/core-model-assets','sdk/ai/core-model-assets.mjs'],
+    ['arcane-os/ai/model-observation','sdk/ai/model-observation.mjs'],
     ['arcane-os/ai/browser-decisions','sdk/ai/browser-decisions.mjs'],
     ['arcane-os/ai/tool-text-stream','sdk/ai/tool-text-stream.mjs'],
     ['arcane-os/ai/twin-cloud','sdk/ai/twin-cloud.mjs'],