@agentsky/desktop-ui 0.0.0-stage → 0.4.65

package/LICENSE

@@ -0,0 +1,37 @@
+AgentSky Desktop UI License
+
+Copyright © 2026 SkillBoss AI. All rights reserved.
+
+This package (@agentsky/desktop-ui, "the Software") is proprietary. It is
+licensed, not sold.
+
+1. Permitted use. You may download and install the Software as published on
+   the npm registry, and run it only as the interface of AgentSky for Mac
+   (the application whose shell is distributed by SkillBoss AI under the
+   Apache License 2.0), on devices you own or control.
+
+2. Restrictions. Except as the law expressly permits, you may not copy the
+   Software other than as needed to install it; modify, translate, adapt or
+   create derivative works of it; redistribute, sublicense, rent, lease or
+   lend it, alone or as part of another product; remove or alter any notice
+   in it; or decompile, disassemble or otherwise reverse engineer it.
+
+3. Ownership. SkillBoss AI and its licensors retain all right, title and
+   interest in the Software, including all intellectual property rights. No
+   rights are granted other than those stated here.
+
+4. Third-party components. The Software bundles open-source components,
+   each under its own license; their notices are kept in the package's
+   dist/ files and those licenses govern those components.
+
+5. Termination. This license ends automatically if you breach it. On
+   termination you must stop using and delete all copies of the Software.
+
+6. No warranty. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
+
+7. Limitation of liability. TO THE EXTENT PERMITTED BY LAW, SKILLBOSS AI
+   SHALL NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL
+   OR PUNITIVE DAMAGES, OR ANY LOSS OF DATA, USE OR PROFITS, ARISING FROM
+   OR RELATED TO THE SOFTWARE.

package/README.md

@@ -1,3 +1,75 @@
-# Temporary Holding Version
+# @agentsky/desktop-ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The interface of AgentSky for Mac: the pages the app's windows show, built
+into `dist/` and served to them by the app's shell. The shell is the Electron
+side of the app, in the directory above this one; the two meet at the bridge
+described in [docs/shell-contract.md](../docs/shell-contract.md), and this
+package names the contract version it was built for in `package.json`
+(`agentsky.shellContract`).
+
+This package is proprietary (see [LICENSE](LICENSE)). Its sources are not
+published: `npm publish` ships `index.js`, `dist/`, the license and this file.
+
+## Layout
+
+```
+src/                 the pages (index.html, quick-ask.html, browser-bar.html,
+                     screen-bar.html), their modules (*.mjs) and styles/
+src/assets/          pictures the pages name by path (web/ and makers/ are
+                     generated copies of the web's)
+src/editors/         the artifact editors, bundled from the web by editors/
+scripts/build.js     builds dist/
+scripts/sync-web-*   regenerate the web-derived files (tokens, icons, logos, Arena)
+editors/             the editors bundle's own build and dependencies
+test/                node --test suites for the modules and the generated files
+dist/                the build output: one script and one stylesheet per page,
+                     the pages rewritten to load them, assets/, editors/ and
+                     vendor/mermaid.js
+```
+
+## Building
+
+```bash
+npm run build        # dist/, minified, as the app ships it
+npm run watch        # rebuild on every change, readable, with source maps
+npm test
+```
+
+Run these here or from the shell's directory with `--workspace ui`; the shell's
+`npm start`, `pack`, `dist` and `test` build this package first. In this
+repository the shell depends on the package as the `ui` npm workspace, so
+`npm install` in the shell's directory installs this package's dependencies too
+and links it into `node_modules/@agentsky/desktop-ui`.
+
+The pages are ES modules with [htm](https://github.com/developit/htm) over
+Preact; `marked`, `dompurify` and `katex` are imported and bundled. Mermaid is
+too large and too dynamic to bundle, so the build copies its prebuilt file to
+`dist/vendor/mermaid.js` and the page loads it as a plain script when the first
+diagram draws. The artifact editors are a bundle of their own
+(`src/editors/`, built by `editors/build.js` from the web app's sources) that
+the page imports when an editor opens; the build copies it as it is.
+
+Everything a page references at run time must end up under `dist/`: the shell
+serves that directory and nothing else, under a content security policy that
+allows no network connection. A page's `<link rel="stylesheet">` lines are
+bundled into one stylesheet in that order; each page has exactly one
+`<script type="module">`, bundled into one script. The build reads these from
+the page's markup, so adding a stylesheet means adding its `<link>`.
+
+## The web's files
+
+Colours, icons, logos and the Arena's lineup come from the web app in this
+repository (`ts/`): `npm run sync:web` regenerates `src/styles/web-tokens.css`,
+`src/web-accents.mjs`, `src/web-icons.mjs`, `src/web-logos.mjs` and
+`src/assets/web/`, and `src/web-arena.mjs`. The outputs are committed so the
+package builds without `ts/`; `npm test` fails when one is stale and skips
+those checks when `ts/` is absent. Change a colour or a logo on the web, never
+in the generated files. The editors bundle and the Market's maker marks are
+regenerated with `cd editors && npm install && npm run build` and
+`node makers.js` there.
+
+## Publishing
+
+The version follows the app's. To publish: `npm run build`, then `npm publish`
+from this directory (the `files` list keeps the sources out). The shell then
+pins the published version instead of the workspace; see the shell's README.