@oddessentials/agent-guild 1.29.0 → 1.30.1

package/src/manager/folder-browser.mjs

@@ -1,8 +1,10 @@
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { readManifest } from './yard-pieces.mjs';
 
 const failure = (status, code, message) => Object.assign(new Error(message), { status, code });
+const PIECE_SCAN = 500;
 const byName = (a, b) => a.name.localeCompare(b.name, undefined, { sensitivity: 'base', numeric: true }) || (a.name < b.name ? -1 : 1);
 
 export function folderSegments(dir, paths = path) {
@@ -30,7 +32,7 @@ export function folderNameProblem(name, platform = process.platform) {
   return null;
 }
 
-export function createFolderBrowser({ platform = process.platform, home = os.homedir(), limit = 2000, driveTimeoutMs = 500, fsp = fs.promises } = {}) {
+export function createFolderBrowser({ platform = process.platform, home = os.homedir(), limit = 2000, driveTimeoutMs = 500, fsp = fs.promises, workshop = null } = {}) {
   const paths = platform === 'win32' ? path.win32 : path.posix;
 
   async function roots() {
@@ -79,6 +81,31 @@ export function createFolderBrowser({ platform = process.platform, home = os.hom
       .map((entry) => ({ name: entry.name, path: paths.join(dir, entry.name) })).sort(byName);
   }
 
+  async function pieceIn(dir, kind) {
+    const file = paths.join(dir, 'piece.json');
+    try {
+      const stat = await fsp.lstat(file);
+      if (!stat.isFile() || stat.size > 16 * 1024) return null;
+      const bytes = await fsp.readFile(file), folder = paths.basename(dir);
+      try {
+        const { title } = readManifest(bytes, kind);
+        return { title: title || folder, folder, path: dir };
+      } catch (err) {
+        const meta = err.newer ? JSON.parse(bytes.toString('utf8')) : null;
+        if (meta?.kind !== kind) return null;
+        const title = typeof meta.title === 'string' && meta.title.length <= 128 && !/\p{Cc}/u.test(meta.title) ? meta.title.trim() : '';
+        return { title: title || folder, folder, path: dir, problem: err.message };
+      }
+    } catch {
+      return null;
+    }
+  }
+
+  async function piecesIn(dir, folders, kind) {
+    const found = await Promise.all([dir, ...folders.slice(0, PIECE_SCAN).map((entry) => entry.path)].map((folder) => pieceIn(folder, kind)));
+    return found.filter(Boolean).sort((a, b) => a.title.localeCompare(b.title, undefined, { sensitivity: 'base', numeric: true }) || (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+  }
+
   const browser = {
     async create(rawParent, rawName) {
       if (typeof rawParent !== 'string' || !rawParent.trim() || rawParent.includes('\0')) throw failure(400, 'bad_path', 'The folder must be a path.');
@@ -103,7 +130,7 @@ export function createFolderBrowser({ platform = process.platform, home = os.hom
       }
       return browser.list(dir);
     },
-    async list(raw, { extension = null } = {}) {
+    async list(raw, { extension = null, pieces = null } = {}) {
       if (raw !== undefined && raw !== null && (typeof raw !== 'string' || raw.includes('\0'))) {
         throw failure(400, 'bad_path', 'The folder must be a path.');
       }
@@ -113,6 +140,7 @@ export function createFolderBrowser({ platform = process.platform, home = os.hom
       const dir = await nearestFolder(wanted);
       const [folders, drives, files] = await Promise.all([entries(dir), roots(), extension ? filesIn(dir, extension) : null]);
       const parent = paths.dirname(dir);
+      const [found, steam] = pieces ? await Promise.all([piecesIn(dir, folders, pieces), workshop ? workshop() : null]) : [null, null];
       return {
         path: dir,
         parent: parent === dir ? null : parent,
@@ -123,6 +151,7 @@ export function createFolderBrowser({ platform = process.platform, home = os.hom
         truncated: folders.length > limit,
         note: dir === wanted ? null : wanted,
         ...(files ? { files: files.slice(0, limit) } : {}),
+        ...(found ? { pieces: found, workshop: steam } : {}),
       };
     },
   };

package/src/manager/main.mjs

@@ -18,6 +18,7 @@ import { GitHub } from './github.mjs';
 import { createManagerServer } from './server.mjs';
 import { YardArt } from './yard-art.mjs';
 import { YardWorlds } from './yard-worlds.mjs';
+import { YardPieces } from './yard-pieces.mjs';
 import { loadPty } from './pty.mjs';
 import { createNotesStore } from './notes.mjs';
 import { createCardNames } from './card-names.mjs';
@@ -188,6 +189,7 @@ export async function startManager({ port = resolvePort(), host = DEFAULT_HOST,
     launcher: launcherPath(),
     yardArt: new YardArt({ webDir, dir: paths.yardArt }),
     yardWorlds: new YardWorlds({ dir: paths.yardWorlds }),
+    yardPieces: new YardPieces({ dir: paths.yardPieces }),
     mcpConnect,
     onShutdownRequest: ({ restart = false } = {}) => shutdown('requested via API', { restart }).then((code) => process.exit(code)),
   });

package/src/manager/server.mjs

@@ -20,6 +20,8 @@ import { MODES as AUTOSTART_MODES } from './autostart.mjs';
 import { ptyRestartProblem } from './pty.mjs';
 import { YardArt } from './yard-art.mjs';
 import { YardWorlds } from './yard-worlds.mjs';
+import { YardPieces } from './yard-pieces.mjs';
+import { createWorkshopFinder } from './steam-workshop.mjs';
 import { spokenText } from './spoken-text.mjs';
 import { MCP_ACTIONS } from './mcp-connect.mjs';
 
@@ -70,8 +72,8 @@ const SECURITY_HEADERS = {
   'Referrer-Policy': 'no-referrer',
   'Cross-Origin-Resource-Policy': 'same-origin',
   'Content-Security-Policy':
-    "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https://i.ytimg.com; " +
-    "connect-src 'self' ws://127.0.0.1:* ws://localhost:*; frame-src https://www.youtube-nocookie.com; " +
+    "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob: https://i.ytimg.com; " +
+    "connect-src 'self' blob: ws://127.0.0.1:* ws://localhost:*; frame-src https://www.youtube-nocookie.com; " +
     "frame-ancestors vscode-webview: vscode-file:; base-uri 'none'; form-action 'none'",
 };
 
@@ -177,7 +179,7 @@ export function createManagerServer({
   notes = createNotesStore(),
   deviceSignIn = new DeviceSignIn({ token }),
   folderOpener = createFolderOpener({ resolveCwd: (cwd) => manager.resolveCwd(cwd) }),
-  folderBrowser = createFolderBrowser(),
+  folderBrowser = createFolderBrowser({ workshop: createWorkshopFinder() }),
   /** The double-click launcher file for this platform, or null when the package carries none. */
   launcher = null,
   /** @type {(opts: { restart: boolean }) => void} */
@@ -187,6 +189,7 @@ export function createManagerServer({
   /** The Yard's art; without a data folder, only a checkout's. */
   yardArt = new YardArt({ webDir }),
   yardWorlds = new YardWorlds(),
+  yardPieces = new YardPieces(),
   mcpConnect = null,
   heartbeatMs = 30000,
 }) {
@@ -300,6 +303,12 @@ export function createManagerServer({
       if (!world) throw new HttpError(404, 'not found', 'not_found');
       return serveFile(req, res, world);
     }
+    if (rel.startsWith('yard/pieces/')) {
+      const [skin, slot, name, ...rest] = rel.slice('yard/pieces/'.length).split('/');
+      const piece = rest.length ? null : yardPieces.file(skin, slot, name);
+      if (!piece) throw new HttpError(404, 'not found', 'not_found');
+      return serveFile(req, res, piece);
+    }
     let root = webDir;
     if (rel.startsWith('yard/assets/')) {
       root = yardArt.assetsDir();
@@ -420,6 +429,10 @@ export function createManagerServer({
     const yardWorld = route.match(/^\/yard-worlds\/([a-z]+)$/);
     if (yardWorld && method === 'PUT') return sendJson(res, 200, { yardWorlds: await yardWorlds.replace(yardWorld[1], (await readJsonBody(req)).path) });
     if (yardWorld && method === 'DELETE') return sendJson(res, 200, { yardWorlds: await yardWorlds.restore(yardWorld[1]) });
+    if (route === '/yard-pieces' && method === 'GET') return sendJson(res, 200, { yardPieces: yardPieces.snapshot() });
+    const yardPiece = route.match(/^\/yard-pieces\/([a-z]+)\/([a-z]+)$/);
+    if (yardPiece && method === 'PUT') return sendJson(res, 200, { yardPieces: await yardPieces.replace(yardPiece[1], yardPiece[2], (await readJsonBody(req)).path) });
+    if (yardPiece && method === 'DELETE') return sendJson(res, 200, { yardPieces: await yardPieces.restore(yardPiece[1], yardPiece[2]) });
     if (route === '/yard/fireworks' && method === 'POST') {
       broadcast({ type: 'yard.fireworks' });
       return sendJson(res, 200, { ok: true, pages: [...eventClients].filter((ws) => !ws.revoked && ws.readyState === ws.OPEN).length });
@@ -447,7 +460,7 @@ export function createManagerServer({
       return sendJson(res, 200, { ok: true });
     }
     if (route === '/folders' && method === 'GET') {
-      return sendJson(res, 200, await folderBrowser.list(url.searchParams.get('path') ?? undefined, { extension: url.searchParams.get('files') === 'agworld' ? '.agworld' : null }));
+      return sendJson(res, 200, await folderBrowser.list(url.searchParams.get('path') ?? undefined, { extension: url.searchParams.get('files') === 'agworld' ? '.agworld' : null, pieces: ['character', 'companion'].includes(url.searchParams.get('pieces')) ? url.searchParams.get('pieces') : null }));
     }
     if (route === '/folders' && method === 'POST') {
       const { path: parent, name } = await readJsonBody(req);
@@ -784,10 +797,11 @@ export function createManagerServer({
   deviceSignIn.on('updated', () => broadcast({ type: 'sign-in.updated' }));
   yardArt.on('updated', (status) => broadcast({ type: 'yard-art.updated', yardArt: status }));
   yardWorlds.on('updated', (worlds) => broadcast({ type: 'yard-worlds.updated', yardWorlds: worlds }));
+  yardPieces.on('updated', (pieces) => broadcast({ type: 'yard-pieces.updated', yardPieces: pieces }));
 
   function handleEvents(ws, req) {
     eventClients.add(ws);
-    const hello = { type: 'hello', version, pid: process.pid, platform: process.platform, startedAt, launcher, folderOpener: folderOpenerFor(req), remoteAccess: remoteAccess ? { available: true } : null, upgrade: upgradeInfo(), yardArt: yardArt.snapshot(), yardWorlds: yardWorlds.snapshot(), sessions: manager.list(), heartbeat: true };
+    const hello = { type: 'hello', version, pid: process.pid, platform: process.platform, startedAt, launcher, folderOpener: folderOpenerFor(req), remoteAccess: remoteAccess ? { available: true } : null, upgrade: upgradeInfo(), yardArt: yardArt.snapshot(), yardWorlds: yardWorlds.snapshot(), yardPieces: yardPieces.snapshot(), sessions: manager.list(), heartbeat: true };
     const notesHello = notes.helloRevision();
     if (notesHello.known) hello.notesRevision = notesHello.revision;
     else hello.notesUnreadable = true;

package/src/manager/steam-workshop.mjs

@@ -0,0 +1,64 @@
+import { execFile } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+export const WORLD_APP = '5462970';
+
+export function parseVdf(text) {
+  const tokens = text.match(/"(?:[^"\\]|\\.)*"|[{}]/g) ?? [];
+  const root = {}, stack = [root];
+  let key = null;
+  for (const token of tokens) {
+    const top = stack[stack.length - 1];
+    if (token === '{') {
+      if (key === null) return root;
+      stack.push(top[key.toLowerCase()] = {});
+      key = null;
+    } else if (token === '}') {
+      if (stack.length > 1) stack.pop();
+      key = null;
+    } else {
+      const value = token.slice(1, -1).replace(/\\(.)/g, '$1');
+      if (key === null) key = value;
+      else { top[key.toLowerCase()] = value; key = null; }
+    }
+  }
+  return root;
+}
+
+function windowsSteam() {
+  return new Promise((resolve) => {
+    execFile('reg', ['query', 'HKCU\\Software\\Valve\\Steam', '/v', 'SteamPath'], { timeout: 5000, windowsHide: true }, (err, stdout) => {
+      resolve(err ? null : String(stdout).match(/SteamPath\s+REG_\w+\s+(.+)/)?.[1]?.trim() || null);
+    });
+  });
+}
+
+export function steamRoots({ platform = process.platform, home = os.homedir(), registry = windowsSteam } = {}) {
+  if (platform === 'win32') return registry().then((root) => (root ? [root] : []));
+  if (platform === 'darwin') return Promise.resolve([path.join(home, 'Library', 'Application Support', 'Steam')]);
+  return Promise.resolve([path.join(home, '.local', 'share', 'Steam'), path.join(home, '.steam', 'steam'), path.join(home, '.var', 'app', 'com.valvesoftware.Steam', '.local', 'share', 'Steam')]);
+}
+
+export async function worldLibrary({ roots = steamRoots(), fsp = fs.promises } = {}) {
+  for (const root of await roots) {
+    let folders;
+    try { folders = parseVdf(await fsp.readFile(path.join(root, 'steamapps', 'libraryfolders.vdf'), 'utf8')).libraryfolders; } catch { continue; }
+    for (const entry of Object.values(folders ?? {})) {
+      if (typeof entry === 'object' && typeof entry.path === 'string' && entry.apps && Object.hasOwn(entry.apps, WORLD_APP)) return path.normalize(entry.path);
+    }
+  }
+  return null;
+}
+
+export function createWorkshopFinder({ library = () => worldLibrary(), fsp = fs.promises } = {}) {
+  let found = null;
+  return async () => {
+    found ??= library().catch(() => null);
+    const root = await found;
+    if (!root) { found = null; return null; }
+    const folder = path.join(root, 'steamapps', 'workshop', 'content', WORLD_APP);
+    return (await fsp.stat(folder).then((stat) => stat.isDirectory(), () => false)) ? folder : null;
+  };
+}