@domglyph/runtime 2.0.0 → 2.1.0

package/README.md

@@ -9,7 +9,7 @@ The browser runtime that makes DOMglyph pages inspectable by AI agents.
 
 ## Overview
 
-`@domglyph/runtime` installs `window.__CORTEX_UI__` — a structured inspection API that AI agents use instead of scraping the DOM.
+`@domglyph/runtime` installs `window.__DOMGLYPH__` — a structured inspection API that AI agents use instead of scraping the DOM.
 
 Without this runtime, an AI agent visiting your page would need to traverse the DOM, parse CSS, infer intent from visible text, and guess at state. With this runtime, the agent calls a single function and gets back a typed, structured description of exactly what is on screen and what can be done.
 
@@ -46,10 +46,10 @@ ReactDOM.createRoot(document.getElementById('root')!).render(<App />);
 Open the browser console on any DOMglyph page and run:
 
 ```js
-console.log(window.__CORTEX_UI__.getScreenContext());
+console.log(window.__DOMGLYPH__.getScreenContext());
 ```
 
-If `__CORTEX_UI__` is defined and returns a context object, the runtime is installed correctly.
+If `__DOMGLYPH__` is defined and returns a context object, the runtime is installed correctly.
 
 ---
 
@@ -71,7 +71,7 @@ getScreenContext(): {
 Example output:
 
 ```js
-window.__CORTEX_UI__.getScreenContext();
+window.__DOMGLYPH__.getScreenContext();
 // {
 //   screen: "order-detail",
 //   entity: "order",
@@ -98,7 +98,7 @@ getAvailableActions(): Array<{
 Example output:
 
 ```js
-window.__CORTEX_UI__.getAvailableActions();
+window.__DOMGLYPH__.getAvailableActions();
 // [
 //   { id: "approve-order", action: "approve-order", state: "idle", section: "actions" },
 //   { id: "cancel-order",  action: "cancel-order",  state: "idle", section: "actions" },
@@ -128,7 +128,7 @@ getFormSchema(formId: string): {
 Example output:
 
 ```js
-window.__CORTEX_UI__.getFormSchema('edit-shipping-form');
+window.__DOMGLYPH__.getFormSchema('edit-shipping-form');
 // {
 //   formId: "edit-shipping-form",
 //   fields: [
@@ -156,7 +156,7 @@ getVisibleEntities(): Array<{
 Example output:
 
 ```js
-window.__CORTEX_UI__.getVisibleEntities();
+window.__DOMGLYPH__.getVisibleEntities();
 // [
 //   { entity: "order",   entityId: "ord-9142", section: "summary" },
 //   { entity: "product", entityId: "prd-001",  section: "line-items" },
@@ -185,7 +185,7 @@ getRecentEvents(): Array<{
 Example output:
 
 ```js
-window.__CORTEX_UI__.getRecentEvents();
+window.__DOMGLYPH__.getRecentEvents();
 // [
 //   { type: "action_triggered", actionId: "approve-order", timestamp: 1711900000000 },
 //   { type: "action_completed", actionId: "approve-order", result: "success", timestamp: 1711900000250 }
@@ -202,7 +202,7 @@ In development, you can install the extended devtools runtime for additional ins
 import { installDOMglyphDevtools } from '@domglyph/runtime';
 
 installDOMglyphDevtools(window);
-// window.__CORTEX_UI_DEVTOOLS__ is now available
+// window.__DOMGLYPH_DEVTOOLS__ is now available
 ```
 
 The devtools runtime adds:
@@ -221,18 +221,18 @@ A typical agent interaction loop using the DOMglyph runtime:
 
 ```js
 // Step 1: Orient — where am I and what entity am I looking at?
-const ctx = window.__CORTEX_UI__.getScreenContext();
+const ctx = window.__DOMGLYPH__.getScreenContext();
 // { screen: "profile", entity: "user", entityId: "usr-42", sections: [...] }
 
 // Step 2: Survey — what actions can I take right now?
-const actions = window.__CORTEX_UI__.getAvailableActions();
+const actions = window.__DOMGLYPH__.getAvailableActions();
 // [{ id: "save-profile", action: "save-profile", state: "idle", section: "contact" }]
 
 // Step 3: Act — trigger the desired action deterministically
 document.querySelector(`[data-ai-id="${actions[0].id}"]`).click();
 
 // Step 4: Verify — did it work?
-const events = window.__CORTEX_UI__.getRecentEvents();
+const events = window.__DOMGLYPH__.getRecentEvents();
 // [{ type: "action_completed", actionId: "save-profile", result: "success", ... }]
 ```
 

package/dist/index.d.ts

@@ -91,13 +91,13 @@ declare function installDOMglyphRuntime(targetWindow?: Window): DOMglyphGlobalAP
 
 declare const runtimeRegistry: RuntimeRegistry;
 declare const defaultRuntimeEvent: "action_triggered";
-declare const CORTEX_UI: DOMglyphGlobalAPI | null;
-declare const CORTEX_UI_DEVTOOLS: DOMglyphDevtoolsAPI | null;
+declare const __DOMGLYPH__: DOMglyphGlobalAPI | null;
+declare const __DOMGLYPH_DEVTOOLS__: DOMglyphDevtoolsAPI | null;
 declare global {
     interface Window {
-        CORTEX_UI?: DOMglyphGlobalAPI;
-        CORTEX_UI_DEVTOOLS?: DOMglyphDevtoolsAPI;
+        __DOMGLYPH__?: DOMglyphGlobalAPI;
+        __DOMGLYPH_DEVTOOLS__?: DOMglyphDevtoolsAPI;
     }
 }
 
-export { type AvailableAction, CORTEX_UI, CORTEX_UI_DEVTOOLS, type DOMglyphDevtoolsAPI, type DOMglyphGlobalAPI, DOMglyphRuntime, type FormFieldSchema, type FormSchema, type RuntimeEventLogEntry, type RuntimeRegistry, type ScreenContext, type VisibleEntity, defaultRuntimeEvent, installDOMglyphDevtools, installDOMglyphRuntime, runtimeRegistry };
+export { type AvailableAction, type DOMglyphDevtoolsAPI, type DOMglyphGlobalAPI, DOMglyphRuntime, type FormFieldSchema, type FormSchema, type RuntimeEventLogEntry, type RuntimeRegistry, type ScreenContext, type VisibleEntity, __DOMGLYPH_DEVTOOLS__, __DOMGLYPH__, defaultRuntimeEvent, installDOMglyphDevtools, installDOMglyphRuntime, runtimeRegistry };

package/dist/index.js

@@ -294,11 +294,11 @@ function installDOMglyphRuntime(targetWindow = window) {
   if (typeof targetWindow === "undefined" || targetWindow.document === void 0) {
     return null;
   }
-  if (targetWindow.CORTEX_UI !== void 0) {
-    return targetWindow.CORTEX_UI;
+  if (targetWindow.__DOMGLYPH__ !== void 0) {
+    return targetWindow.__DOMGLYPH__;
   }
   const runtime = new DOMglyphRuntime(targetWindow, targetWindow.document);
-  targetWindow.CORTEX_UI = runtime;
+  targetWindow.__DOMGLYPH__ = runtime;
   return runtime;
 }
 function parseStates(value) {
@@ -363,15 +363,15 @@ function installDOMglyphDevtools(targetWindow = window) {
   if (typeof targetWindow === "undefined" || targetWindow.document === void 0) {
     return null;
   }
-  if (targetWindow.CORTEX_UI_DEVTOOLS !== void 0) {
-    return targetWindow.CORTEX_UI_DEVTOOLS;
+  if (targetWindow.__DOMGLYPH_DEVTOOLS__ !== void 0) {
+    return targetWindow.__DOMGLYPH_DEVTOOLS__;
   }
-  const runtime = targetWindow.CORTEX_UI ?? installDOMglyphRuntime(targetWindow);
+  const runtime = targetWindow.__DOMGLYPH__ ?? installDOMglyphRuntime(targetWindow);
   if (runtime === null) {
     return null;
   }
   const devtools = new DOMglyphDevtoolsOverlay(targetWindow, runtime);
-  targetWindow.CORTEX_UI_DEVTOOLS = devtools;
+  targetWindow.__DOMGLYPH_DEVTOOLS__ = devtools;
   return devtools;
 }
 var DOMglyphDevtoolsOverlay = class {
@@ -473,8 +473,8 @@ var DOMglyphDevtoolsOverlay = class {
       dispose();
     }
     this.root.remove();
-    if (this.win.CORTEX_UI_DEVTOOLS === this) {
-      delete this.win.CORTEX_UI_DEVTOOLS;
+    if (this.win.__DOMGLYPH_DEVTOOLS__ === this) {
+      delete this.win.__DOMGLYPH_DEVTOOLS__;
     }
   }
   isVisible() {
@@ -616,12 +616,12 @@ var runtimeRegistry = {
   ]
 };
 var defaultRuntimeEvent = AIEvent2.ACTION_TRIGGERED;
-var CORTEX_UI = typeof window === "undefined" ? null : installDOMglyphRuntime(window);
-var CORTEX_UI_DEVTOOLS = typeof window === "undefined" ? null : installDOMglyphDevtools(window);
+var __DOMGLYPH__ = typeof window === "undefined" ? null : installDOMglyphRuntime(window);
+var __DOMGLYPH_DEVTOOLS__ = typeof window === "undefined" ? null : installDOMglyphDevtools(window);
 export {
-  CORTEX_UI,
-  CORTEX_UI_DEVTOOLS,
   DOMglyphRuntime,
+  __DOMGLYPH_DEVTOOLS__,
+  __DOMGLYPH__,
   defaultRuntimeEvent,
   installDOMglyphDevtools,
   installDOMglyphRuntime,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domglyph/runtime",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -15,7 +15,7 @@
     "dist"
   ],
   "dependencies": {
-    "@domglyph/ai-contract": "2.0.0"
+    "@domglyph/ai-contract": "2.1.0"
   },
   "devDependencies": {
     "tsup": "^8.5.1"