arcane-os 0.37.0 → 0.38.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.38.0
+
+- Add `User.AI_name` as an application-owned complete string with an empty-string
+  default, ordinary getter/setter, profile loading and `updateExplicit` support.
+  Preserve older saved profiles and restore the hydrated baseline after a failed
+  save; no existing history or provider/model selection is rewritten.
+- Distinguish saved conversation speakers in file previews using the shared
+  action/action-text colors for user cards and surface/text colors for assistant
+  cards. Assistant headings use the complete saved nonblank string name or `AI`,
+  without a role suffix. Preserve other role labels, timestamps, status, complete
+  content and persistence. Capturing names on new Chat turns is separate work.
+
 ## 0.37.0
 
 - Add opt-in `markdown-editor` fit layout and preview following 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.37.0` SDK contract. Applications pin one exact npm
+This checkout defines the `0.38.0` 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

@@ -421,7 +421,7 @@
       ],
       "availability": "Browser and supported native WebViews",
       "transport": "HTMLImport + DOM; injected Arcane/provider modules where listed",
-      "normalization": "Selection/filter state and neutral previews normalized; storage/provider behavior mixed. Initial directoryFilter and setDirectoryFilter(fn|null) use false-only exclusion before built-in DBOPFS key/metadata reads; data-hidden-prefixes also applies to directories unless data-show-hidden is present. Existing file predicates preserve their first argument and receive optional directory/fileName/path/layout context. previewDescriptor(original File,{directory,fileName,extension,path,mimeType,signal}) may asynchronously return text/markdown/html/json content, conversation messages with role/content/real timestamp and optional name/status, collection items, or image/audio/pdf/download content as Blob/File or a lazy ({signal}) loader. Downloads require fileName; descriptors accept title and images accept alt. Lazy items load only on explicit request and retain item-local retry. Close, replacement, and destroy abort the preview signal, suppress late output, remove iframe srcdoc, stop audio, and revoke all owned object URLs. HTML preserves the exact string in iframe srcdoc; HTML/Markdown MIME fallback supports extensionless files. Nullish descriptors preserve previewTransform for JSON-family files and native previews; untransformed JSONL/NDJSON retains complete raw text, and other binary files download the original File."
+      "normalization": "Selection/filter state and neutral previews normalized; storage/provider behavior mixed. Initial directoryFilter and setDirectoryFilter(fn|null) use false-only exclusion before built-in DBOPFS key/metadata reads; data-hidden-prefixes also applies to directories unless data-show-hidden is present. Existing file predicates preserve their first argument and receive optional directory/fileName/path/layout context. previewDescriptor(original File,{directory,fileName,extension,path,mimeType,signal}) may asynchronously return text/markdown/html/json content, conversation messages with role/content/real timestamp and optional name/status, collection items, or image/audio/pdf/download content as Blob/File or a lazy ({signal}) loader. Assistant conversation labels use the exact nonblank string name or AI without a role suffix; other role labels retain existing name/role presentation. User and assistant cards have distinct theme backgrounds and preserve data-role. Downloads require fileName; descriptors accept title and images accept alt. Lazy items load only on explicit request and retain item-local retry. Close, replacement, and destroy abort the preview signal, suppress late output, remove iframe srcdoc, stop audio, and revoke all owned object URLs. HTML preserves the exact string in iframe srcdoc; HTML/Markdown MIME fallback supports extensionless files. Nullish descriptors preserve previewTransform for JSON-family files and native previews; untransformed JSONL/NDJSON retains complete raw text, and other binary files download the original File."
     },
     {
       "file": "runtime/arcane/components/header.html",

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

@@ -19,7 +19,7 @@
     {"file":"runtime/arcane/entities/Preference.js","exports":["default","preferenceSchema"],"availability":"cross-host","normalization":"normalized"},
     {"file":"runtime/arcane/entities/TerminalSession.js","exports":["default","terminalShells"],"availability":"cross-host","normalization":"normalized"},
     {"file":"runtime/arcane/entities/Theme.js","exports":["arcaneDarkThemeTokens","arcaneLightThemeTokens","default","themeColorToHex","themeTokens"],"availability":"cross-host/dom-when-applied","normalization":"normalized/mixed"},
-    {"file":"runtime/arcane/entities/User.js","exports":["default","profileUpdateFromSearchParams"],"availability":"browser/native-webview","normalization":"updateExplicit accepts existing partial/JSON updates or an awaited fresh-profile callback under the existing serialized write owner; callback null skips saving and returns the fresh profile, while failed writes restore the fresh baseline. Timestamp setters persist partial fields through that owner. profileUpdateFromSearchParams purely maps nonempty supplied URLSearchParams values without further decoding, trimming, or persistence."},
+    {"file":"runtime/arcane/entities/User.js","exports":["default","profileUpdateFromSearchParams"],"availability":"browser/native-webview","normalization":"AI_name is a persisted string preference with an empty-string default that preserves complete supplied text alongside AI_personality; loading older records does not rewrite them. updateExplicit accepts existing partial/JSON updates or an awaited fresh-profile callback under the existing serialized write owner; callback null skips saving and returns the fresh profile, while failed writes restore the fresh baseline. Timestamp setters persist partial fields through that owner. profileUpdateFromSearchParams purely maps nonempty supplied URLSearchParams values without further decoding, trimming, or persistence."},
     {"file":"runtime/arcane/entities/Weather.js","exports":["WeatherDay","WeatherLocation","WeatherObservation","WeatherSnapshot"],"availability":"cross-host","normalization":"normalized"}
   ]
 }

package/docs/reference/runtime-components.md

@@ -844,7 +844,11 @@ Each descriptor accepts an optional `title`. Supported shapes are:
 | `image`, `audio`, `pdf`, `download` | `content`: a `Blob` or `File`, or a function receiving `{signal}` and resolving to one |
 
 Conversation `role` and complete Markdown `content` are strings. Optional
-`name` and `status` are displayed alongside the role and time. Valid supplied
+assistant `name` is displayed exactly when it is a nonblank string; otherwise
+the assistant label is `AI`, without a role suffix. User and other role labels
+retain their supplied name alongside the role. User and assistant cards use
+distinct shared-theme backgrounds, and each card retains its original
+`data-role`. Optional `status` is displayed beside the time. Valid supplied
 timestamps are displayed in local time with their real ISO datetime; absent
 timestamps display `Time unavailable`, and an unrecognized supplied timestamp
 is displayed as supplied. No timestamp is invented.

package/docs/reference/runtime-entities.md

@@ -274,6 +274,29 @@ Owns persisted user preference/profile fields, explicit-preference updates,
 fresh reads, saves, and JSON projection. It installs `window.user` after its
 DBLS/DBOPFS lifecycle and emits `user-entity-loaded`.
 
+### AI_name
+
+Saved AI-name preference alongside `AI_personality`. It is a string with an
+empty-string default and preserves the complete supplied text, including
+Unicode, whitespace, and an explicitly empty value. The property setter follows
+the same persistence setting as `AI_personality`; non-string assignments throw
+`Error('AI_name must be string')`.
+
+`explicit`, `toJSON()`, `load()`, `refresh()`, and `updateExplicit()` include
+this field through the existing profile schema. Loading an older record that
+omits it leaves a new entity's empty default in memory and does not rewrite the
+stored record. Partial updates that omit it retain the current value.
+
+```javascript
+await user.updateExplicit(
+    {AI_name: 'Captain Moonboots'}
+);
+```
+
+The application owns naming choices and any mapping to its AI display name;
+this preference changes neither the human `username` nor chat history. No
+automatic migration or naming policy runs when it is loaded or saved.
+
 ### updateExplicit(update)
 
 Accepts an ordinary partial profile object, a JSON string, or a function

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "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/file-manager.html

@@ -387,6 +387,21 @@
         background:var(--background);
     }
 
+    .file-preview-message[data-role="user"]{
+        background:var(--arcane-action,var(--primary-color));
+        color:var(--arcane-action-text,var(--button-text-color,var(--text-color)));
+        border-color:var(--arcane-action,var(--primary-color));
+    }
+
+    .file-preview-message[data-role="user"] a{
+        color:inherit;
+    }
+
+    .file-preview-message[data-role="assistant"]{
+        background:var(--arcane-surface,var(--background));
+        color:var(--text-color);
+    }
+
     .file-preview-message header,
     .file-preview-message footer{
         display:flex;
@@ -1740,9 +1755,15 @@
                         const time=document.createElement('time');
                         article.className='file-preview-message';
                         article.dataset.role=message.role;
-                        speaker.textContent=message.name===undefined
-                            ?message.role
-                            :`${message.name} · ${message.role}`;
+                        if(message.role==='assistant'){
+                            speaker.textContent=is.string(message.name)&&message.name.trim()
+                                ?message.name
+                                :'AI';
+                        }else{
+                            speaker.textContent=message.name===undefined
+                                ?message.role
+                                :`${message.name} · ${message.role}`;
+                        }
                         header.append(speaker);
                         if(message.timestamp===undefined||message.timestamp===null){
                             time.textContent='Time unavailable';

package/runtime/arcane/entities/User.js

@@ -110,6 +110,7 @@ function userEntityLifecycleError(code,reason,message){
  * @property {string|number} contact_4
  * @property {string|number} contact_5
  * @property {string|number} contact_6
+ * @property {string} AI_name
  * @property {string} AI_personality
  * @property {string} religion
  * @property {string} AI_voice
@@ -176,6 +177,7 @@ class UserEntity {
         'contact_5',
         'contact_6',
 
+        'AI_name',
         'AI_personality',
         'religion',
         'AI_voice',
@@ -211,6 +213,7 @@ class UserEntity {
     #contact_5 = '';
     #contact_6 = '';
 
+    #aiName = '';
     #AI_personality = '';
     #religion = '';
     #AI_voice = '';
@@ -515,6 +518,22 @@ class UserEntity {
 
 
 
+    /** @returns {string} */
+    get AI_name() {
+        return this.#aiName;
+    }
+
+    /** @param {string} v */
+    set AI_name(v) {
+        if (!is.string(v)) {
+            throw new Error('AI_name must be string');
+        }
+
+        this.#aiName = v;
+
+        this.#persist();
+    }
+
     /** @returns {string} */
     get AI_personality(){
         return this.#AI_personality;
@@ -889,6 +908,7 @@ class UserEntity {
                     this.persist=persist;
                 }
 
+                baseline = this.explicit;
                 const conditional=is.function(src);
                 const update=conditional?await src(this.explicit):src;
                 if(conditional&&update===null){