@quo-systems/dock 0.2.3 → 0.2.5

package/human/web.ts

@@ -23,6 +23,8 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import { existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
+import { join } from 'node:path';
+import process from 'node:process';
 import { build } from 'esbuild';
 import type { DiskHarbor, Hosted } from '../harbor/disk.ts';
 import { door } from './door.ts';
@@ -33,16 +35,28 @@ export type WebOptions = {
 };
 
 // The paths under `/web` that are the exchange's, never a ward's name.
-const RESERVED_PATHS = new Set(['allow', 'tab.js']);
+const RESERVED_PATHS = new Set(['allow', 'tab.js', 'beings.js']);
+
+// The world's code for the tab: a module in the harbor folder, the twin of
+// `classes/index.ts`, exporting by name the classes the tab boots into its
+// local ward for a world of this harbor. Served bundled as `beings.js` on
+// this origin, and one origin is one world's code.
+export const TAB_CODE = 'tab/index.ts';
 
 export function webRoute(harbor: DiskHarbor, o: WebOptions): (req: IncomingMessage, res: ServerResponse, rest: string) => Promise<boolean> {
   const tabEntry = () => {
     const js = fileURLToPath(new URL('./tab.js', import.meta.url));
     return existsSync(js) ? js : fileURLToPath(new URL('./tab.ts', import.meta.url));
   };
+  const beingsEntry = join(harbor.dir, TAB_CODE);
+  const bundled = (entry: string) =>
+    // the entry may sit in a harbor folder with no node_modules of its own, as on a droplet whose
+    // estate folder is the working directory: what it imports is resolved from there too
+    build({ entryPoints: [entry], bundle: true, format: 'esm', platform: 'browser', target: 'es2023', write: false, nodePaths: [join(process.cwd(), 'node_modules')] }).then((out) => out.outputFiles[0]!.text);
   let bundle: Promise<string> | undefined;
-  const built = () =>
-    (bundle ??= build({ entryPoints: [tabEntry()], bundle: true, format: 'esm', platform: 'browser', target: 'es2023', write: false }).then((out) => out.outputFiles[0]!.text));
+  const built = () => (bundle ??= bundled(tabEntry()));
+  let beings: Promise<string> | undefined;
+  const builtBeings = () => (beings ??= bundled(beingsEntry));
   const quoOrigin = (() => {
     try {
       const u = new URL(o.at.quo);
@@ -71,7 +85,7 @@ export function webRoute(harbor: DiskHarbor, o: WebOptions): (req: IncomingMessa
   };
   const wards = () => Object.fromEntries([...harbor.wards].map(([n, h]) => [n, { pk: h.pk, public: publicOf(h) !== null }]));
   const tab = (ward?: string) => {
-    const cfg = { quo: o.at.quo, web: o.at.web, wards: wards(), ...(ward ? { ward } : {}) };
+    const cfg = { quo: o.at.quo, web: o.at.web, wards: wards(), beings: existsSync(beingsEntry), ...(ward ? { ward } : {}) };
     return `<script id="quo" type="application/json">${JSON.stringify(cfg).replace(/</g, '\\u003c')}</script><script type="module" src="${o.at.web}/tab.js"></script>`;
   };
   return async (req, res, rest) => {
@@ -88,6 +102,13 @@ export function webRoute(harbor: DiskHarbor, o: WebOptions): (req: IncomingMessa
       res.end(await built());
       return true;
     }
+    // the world's code for the tab, when the harbor folder holds any; a harbor with none has no such path
+    if (rest === '/beings.js' && req.method === 'GET') {
+      if (!existsSync(beingsEntry)) return false;
+      res.writeHead(200, { 'content-type': 'text/javascript; charset=utf-8', 'cache-control': 'no-store' });
+      res.end(await builtBeings());
+      return true;
+    }
     const wardName = parts[0] ?? '';
     if (!wardName || RESERVED_PATHS.has(wardName)) return false;
     const hosted = harbor.wards.get(wardName);
@@ -104,18 +125,26 @@ const CSS = [
   ':root{color-scheme:light dark;--accent:#3b6ef5;--bg:transparent;--fg:inherit;--font:system-ui,sans-serif;--radius:6px;--ink:#1c1b22;--paper:#fbfaf7;--mute:#6b6a73}',
   '@media(prefers-color-scheme:dark){:root{--ink:#ecebe6;--paper:#141318;--mute:#9a99a2}}',
   'html{background:var(--paper);color:var(--ink)}',
-  'body{font:16px/1.5 system-ui,sans-serif;max-width:40rem;margin:2rem auto;padding:0 1rem}',
+  // one column that is a phone first and a desk after: the same page, more air
+  'body{font:16px/1.5 system-ui,sans-serif;max-width:40rem;margin:1rem auto;padding:0 1rem}@media(min-width:40rem){body{margin:2rem auto}}',
+  'input:not([type=checkbox]),select,textarea{width:100%;max-width:24rem;box-sizing:border-box}',
   'nav.worlds{display:flex;flex-wrap:wrap;gap:.5rem 1rem;font-size:.9rem;opacity:.8}nav.worlds a[aria-current]{font-weight:600}',
   'nav.relations{display:flex;flex-wrap:wrap;gap:.25rem;margin:.5rem 0}nav.relations button{background:transparent;color:inherit;border:1px solid color-mix(in srgb,currentColor 30%,transparent)}nav.relations button[aria-current]{border-color:var(--accent);font-weight:600}',
   'header,main{background:var(--bg);color:var(--fg);font-family:var(--font)}header{display:flex;flex-wrap:wrap;align-items:center;gap:.5rem 1rem}header .notice{width:100%;margin:0}',
   'input,select,textarea,button{font:inherit;padding:.4rem;margin:.2rem;border-radius:var(--radius)}button{background:var(--accent);color:#fff;border:0;padding:.4rem .9rem}',
   'fieldset{border:1px solid color-mix(in srgb,currentColor 20%,transparent);border-radius:var(--radius);margin:.5rem 0}',
+  // a being of the world running in the tab: her own section under the far page
+  'section.local{border-top:1px solid color-mix(in srgb,currentColor 15%,transparent);margin:1.5rem 0;padding-top:.5rem}section.local header:empty{display:none}',
   'section.standing{background:var(--bg);color:var(--fg);font-family:var(--font);border-left:4px solid var(--accent);border-radius:var(--radius);padding:.25rem 1rem;margin:1.5rem 0}section.standing h2{display:flex;align-items:center;gap:.5rem;font-size:1.1rem}img.logo{height:1.6rem}',
   'table{border-collapse:collapse}td,th{padding:.15rem .5rem;text-align:left}.answer{margin:.5rem 0 1rem;padding:.5rem;border-left:3px solid var(--accent)}.answer.error{border-color:#c33}.answer.silence,.answer.word,.answer.unreached{border-color:#c93}pre{padding:.75rem;overflow:auto}',
   // a page in the grammar: regions, roles, cards
   '.page .stack{display:flex;flex-direction:column;gap:.5rem}.page .row{display:flex;flex-wrap:wrap;gap:.5rem 1rem;align-items:baseline}',
   '.page .t-title{font-size:2rem;font-weight:600;letter-spacing:-.02em;margin:.5rem 0}.page .t-lead{font-size:1.25rem;margin:.25rem 0}.page .t-label{font-size:.8rem;letter-spacing:.06em;text-transform:uppercase;color:var(--mute);margin:0}.page .t-quiet{color:var(--mute);font-size:.9rem}.page .t-body{margin:.25rem 0}',
   '.page .picture{max-height:6rem}.cards{display:flex;flex-wrap:wrap;gap:.75rem}.card{border:1px solid color-mix(in srgb,currentColor 20%,transparent);border-radius:var(--radius);padding:.5rem .75rem}',
+  // a row with a picture is a line about someone or something: the picture small and the words beside it, centred
+  '.page .row:has(>.picture){align-items:center;flex-wrap:nowrap}.page .row>.picture{max-height:2.75rem;flex:none}.page .row>.stack{gap:0;min-width:0}.page .row>.stack>p{margin:0}',
+  // a far page inside a standing's section: her title is a section's, not the page's
+  'section.standing .page{padding:.5rem 0}section.standing .page .t-title{font-size:1.3rem;margin:.25rem 0}',
   // the door page: one column, generous air, the mark, a word, a sentence
   'main.door{min-height:70vh;display:flex;flex-direction:column;justify-content:center;align-items:flex-start;max-width:32rem;margin:0 auto;padding:3rem 0;font-family:ui-serif,Georgia,"Times New Roman",serif}',
   'main.door .picture{width:3.5rem;height:3.5rem;color:var(--ink);opacity:.9;margin-bottom:1.25rem}',

package/mcp/runner.ts

@@ -13,6 +13,7 @@
 import type { Blueprint, JsonObject } from '@quo-systems/quo';
 import type { Avatar } from '../beings/avatar.ts';
 import { word, wordText, SILENCE_TEXT, UNREACHED_TEXT, type Serving } from '../beings/side.ts';
+import { presentation } from '../beings/look.ts';
 
 // Where the model is. `key` is a bearer for endpoints that want one, read
 // from the device and never from cells. `turns` is the ceiling of model
@@ -32,11 +33,12 @@ type Completion = { choices: { message: { role: 'assistant'; content: string | n
 // Her describe, spoken as a tools array. Name, description and input are
 // verbatim, with the one narrowing an endpoint has asked for: an ask that
 // declares no properties is sent with an empty `properties`, because
-// LM Studio refuses a parameters schema without one. `look` and `page` are
-// presentation, for a screen, and are not functions.
+// LM Studio refuses a parameters schema without one. Her look, her page and
+// every carried page are presentation, for a screen, and are not functions.
 export function tools(bp: Blueprint): Tool[] {
+  const shown = presentation(bp);
   return bp.asks
-    .filter((a) => a.name !== 'look' && a.name !== 'page')
+    .filter((a) => !shown.has(a.name))
     .map((a) => {
       const t: Tool = { type: 'function', function: { name: a.name, parameters: { properties: {}, ...a.input, type: 'object' } } };
       if (a.description !== undefined) t.function.description = a.description;

package/mcp/server.ts

@@ -13,7 +13,7 @@ import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import { ListToolsRequestSchema, CallToolRequestSchema, type CallToolResult, type Tool } from '@modelcontextprotocol/sdk/types.js';
 import type { Blueprint, JsonObject } from '@quo-systems/quo';
 import { word, wordText, SILENCE_TEXT, UNREACHED_TEXT, type Serving, type Subject } from '../beings/side.ts';
-import { hintFor, sanitise, type Look } from '../beings/look.ts';
+import { hintFor, presentation, sanitise, type Look } from '../beings/look.ts';
 import { isSilence, isWord, digest } from '@quo-systems/quo';
 import type { Json } from '@quo-systems/quo';
 
@@ -28,10 +28,12 @@ export const DESCRIBE: Tool = { name: 'describe', description: 'the empty ask: h
 // Her describe, spoken as tools, the empty ask first. Name, description and
 // input are verbatim; an output schema crosses when she declared one. Her
 // look, when she has one, is the hints: a title, and the annotations a host
-// reads. The `look` ask itself is presentation, and is not a tool.
+// reads. Her look, her page and every carried page are presentation, for a
+// screen, and are not tools.
 export function tools(bp: Blueprint, look: Look = {}): Tool[] {
+  const shown = presentation(bp);
   const asks = bp.asks
-    .filter((a) => a.name !== 'look' && a.name !== 'page') // presentation, for a screen, and not a tool
+    .filter((a) => !shown.has(a.name))
     .map((a) => {
       const t: Tool = { name: a.name, inputSchema: { ...a.input, type: 'object' } };
       if (a.description !== undefined) t.description = a.description;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quo-systems/dock",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "The dock: what every estate on Quo needs and nobody writes twice. A daemon and the quo command, the front desk, the user being and the avatar, harbors on disk, in a tab and on the edge, the model sides and the screen.",
   "keywords": [
     "quo",
@@ -31,6 +31,10 @@
       "types": "./dist/harbor/browser.d.ts",
       "default": "./dist/harbor/browser.js"
     },
+    "./harbor/capacitor": {
+      "types": "./dist/harbor/capacitor.d.ts",
+      "default": "./dist/harbor/capacitor.js"
+    },
     "./cli/daemon": {
       "types": "./dist/cli/daemon.d.ts",
       "default": "./dist/cli/daemon.js"
@@ -55,6 +59,10 @@
       "types": "./dist/human/html.d.ts",
       "default": "./dist/human/html.js"
     },
+    "./human/local": {
+      "types": "./dist/human/local.d.ts",
+      "default": "./dist/human/local.js"
+    },
     "./harbor/edge/worker": {
       "types": "./dist/harbor/edge/worker.d.ts",
       "default": "./dist/harbor/edge/worker.js"
@@ -67,8 +75,12 @@
     "prepublishOnly": "cd ../.. && npm run check && npm run check:terrain"
   },
   "dependencies": {
+    "@aparajita/capacitor-secure-storage": "^8.0.0",
+    "@capacitor/app": "^8.1.1",
+    "@capacitor/core": "^8.5.1",
+    "@capacitor/filesystem": "^8.1.3",
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@quo-systems/quo": "^0.2.3",
+    "@quo-systems/quo": "^0.2.5",
     "esbuild": "^0.28.2",
     "ws": "^8.21.3"
   },