House Management Prototype
++ Mirrors the current unlock and media-slot workflow. This is a design shell, not wired to backend state. +
+ +
+
+
+
+
+
+ Unlock
+Sign with wallet to unlock encrypted house state.
+
+
+
+
+ No unencrypted key material is stored server-side.
+
+
+ ERC-8004 Link
+Attach chain-aware identity and publish discoverable mapping when requested.
+
+
+
+
+
+ Opt-out should remove storefront visibility and hide public share by default.
+
+
+ Media Slots
+Share hero + human avatar + agent avatar + future service cards.
+
+ shareHeroImageUrl
+ humanAvatarImageUrl
+ agentAvatarImageUrl
+ serviceCardImages[]
+
+
+ Signups: 3,412
+ Public teams: {LEADERBOARD_ROWS.length}
+ Referrals: 339
+
+
+
+
+
+ Team
+ Chain
+ Referrals
+ Views
+
+ {LEADERBOARD_ROWS.map((row) => (
+
+ {row.team}
+ {row.chain}
+ {row.referrals}
+ {row.views}
+
+ ))}
+ Public Share Prototype
++ High-distribution card style for social sharing. Supports generated house hero and linked service products. +
+ +
+
+
+
+ House Hero
+ Generated Wild-West house image
+ Prompt should include style anchor + district scene + agent persona cues.
+
+
+ Team
+ human: alex-river • agent: proof-ranger
+
+
+
+ Open storefront
+
+
+ X post linked
+ Moltbook linked
+ services: 3
+
+ Quest: Portal Onboarding
++ Prototype of the full trainer surface: attempts, timeline, tool lab, integrity checks, and loadouts. +
+ +
+
+
+
+
+
+
+
+
+
+
+
+ Attempts
+
+ {TRAINER_ATTEMPTS.map((attempt) => (
+
+
+ {attempt.id}
+ {attempt.status}
+ score {(attempt.score * 100).toFixed(0)}%
+
+ ))}
+
+
+ Inspector + Tools
+
+ Trace
+ Tool Lab
+ Traffic
+ Session
+
+ tool.invoke({`{ name: 'claim.create', args: { chain: 'evm' } }`})
+
+ Agent Worker Dock
+
+ {open ? (
+
+ session: active
+
+
+
+
+ ) : null}
+
+ Comms
+
+ Human + agent message stream, approvals, and co-op controls.
+
+
+
+
+
+ Debug Views
+
+ Tools, skill context, worker traffic, brain, and session context tabs.
+
+ tools
+ traffic
+ brain
+ trainer
+
+
+
+
+
+
+ {activeStorefront ? (
+ Atlas District Map
++ Log-scaled districts by chain + testnet pair, with storefront drawer and opt-out pattern. +
+ +
+
+ setQuery(event.target.value)}
+ placeholder="service, chain, agent"
+ style={{ maxWidth: 280 }}
+ />
+
+
+
+
+
+ {DISTRICTS.map((district) => (
+
+ ))}
+
+
+
+
+
+ {activeDistrictData ? activeDistrictData.name : 'District'}
+ service-like: {activeDistrictData?.serviceCount.toLocaleString() || 0}
+
+ Scene seed: {activeDistrictData?.scene || 'n/a'}
+
+ {districtAgents.map((entry) => (
+
+
+ {entry.name}
+
+
+ ))}
+
+
+
+
+ ) : null}
+
+ {activeStorefront.name}
+
+
+
+
+
+
+ Agent ID
+ {activeStorefront.id}
+ {activeStorefront.summary}
+
+ Endpoint: {activeStorefront.endpoint}
+
+
+ Actions
+
+
+
+
+
+ + Opt-out flow should require ERC-8004 ownership signature and soft-delete the pre-registered house. +
+
+
+
+
+
+ {title || 'Agent Town'}
+ {subtitle || 'Human + agent co-op shell'}
+
+
+
+
+
+ Town Hub Prototype
++ One-screen navigation model with district modals, trainer modal, and persistent agent dock. +
+ +
+ {HOTSPOTS.map((spot) => (
+
+ ))}
+
+
+
+ districts: {DISTRICTS.length}
+ agents: {mapSummary.totalAgents.toLocaleString()}
+ service-like: {mapSummary.totalServices.toLocaleString()}
+
+
+
+ ) : null}
+
+ {trainerOpen ? (
+
+
+
+ {detail.title}
+
+
+ {detail.body}
+
+ {detail.links.map((item) => (
+
+ {item.label}
+
+ ))}
+
+
+
+
+
+
+ ) : null}
+
+ );
+}
diff --git a/prototypes/v0-next/lib/mockData.js b/prototypes/v0-next/lib/mockData.js
new file mode 100644
index 0000000..cffb13f
--- /dev/null
+++ b/prototypes/v0-next/lib/mockData.js
@@ -0,0 +1,199 @@
+export const DISTRICTS = [
+ {
+ id: 'ethereum',
+ name: 'Ethereum + Sepolia',
+ family: 'EVM',
+ agentCount: 18240,
+ serviceCount: 1210,
+ x: '14%',
+ y: '20%',
+ scene: 'sandstone exchange district with brass rails and sky tram'
+ },
+ {
+ id: 'base',
+ name: 'Base + Base Sepolia',
+ family: 'EVM',
+ agentCount: 6350,
+ serviceCount: 820,
+ x: '38%',
+ y: '17%',
+ scene: 'blue steel workshop quarter with relay towers'
+ },
+ {
+ id: 'bnb',
+ name: 'BNB + Chapel',
+ family: 'EVM',
+ agentCount: 3420,
+ serviceCount: 410,
+ x: '62%',
+ y: '23%',
+ scene: 'gold market street with lantern canopies'
+ },
+ {
+ id: 'polygon',
+ name: 'Polygon + Amoy',
+ family: 'EVM',
+ agentCount: 2910,
+ serviceCount: 280,
+ x: '21%',
+ y: '56%',
+ scene: 'terraced canyon district with rope bridges'
+ },
+ {
+ id: 'arbitrum',
+ name: 'Arbitrum + Sepolia',
+ family: 'EVM',
+ agentCount: 2270,
+ serviceCount: 350,
+ x: '49%',
+ y: '52%',
+ scene: 'clockwork rail junction with mirrored saloons'
+ },
+ {
+ id: 'solana',
+ name: 'Solana Devnet',
+ family: 'Solana',
+ agentCount: 1991,
+ serviceCount: 310,
+ x: '74%',
+ y: '55%',
+ scene: 'sunlit crystal harbor with kinetic docks'
+ }
+];
+
+export const STOREFRONTS = [
+ {
+ id: 'evm:1:101',
+ districtId: 'ethereum',
+ chain: 'Ethereum',
+ name: 'Proof Ranger',
+ summary: 'Verifies signed payloads and emits attestations for downstream apps.',
+ quality: 0.92,
+ services: ['verify', 'attest', 'webhook'],
+ endpoint: 'https://proof-ranger.example/api',
+ avatar: '/fixtures/avatars/proof-ranger.png'
+ },
+ {
+ id: 'evm:1:102',
+ districtId: 'ethereum',
+ chain: 'Ethereum',
+ name: 'Ledger Marshal',
+ summary: 'Monitors contract events and publishes compliance digest every hour.',
+ quality: 0.89,
+ services: ['events', 'digest'],
+ endpoint: 'https://ledger-marshal.example/api',
+ avatar: '/fixtures/avatars/ledger-marshal.png'
+ },
+ {
+ id: 'evm:8453:56',
+ districtId: 'base',
+ chain: 'Base',
+ name: 'Signal Sheriff',
+ summary: 'Routes intent bundles to preferred liquidity sources.',
+ quality: 0.86,
+ services: ['routing', 'quote'],
+ endpoint: 'https://signal-sheriff.example/api',
+ avatar: '/fixtures/avatars/signal-sheriff.png'
+ },
+ {
+ id: 'evm:8453:57',
+ districtId: 'base',
+ chain: 'Base',
+ name: 'Claim Courier',
+ summary: 'Creates pre-registration claims and wallet-bound invitation proofs.',
+ quality: 0.84,
+ services: ['invite', 'claim'],
+ endpoint: 'https://claim-courier.example/api',
+ avatar: '/fixtures/avatars/claim-courier.png'
+ },
+ {
+ id: 'evm:56:88',
+ districtId: 'bnb',
+ chain: 'BNB',
+ name: 'Fee Wrangler',
+ summary: 'Predicts gas windows and batches outbound writes.',
+ quality: 0.81,
+ services: ['gas', 'batch'],
+ endpoint: 'https://fee-wrangler.example/api',
+ avatar: '/fixtures/avatars/fee-wrangler.png'
+ },
+ {
+ id: 'evm:137:91',
+ districtId: 'polygon',
+ chain: 'Polygon',
+ name: 'Mosaic Foreman',
+ summary: 'Builds media manifests for share pages and OG payloads.',
+ quality: 0.79,
+ services: ['media', 'manifest'],
+ endpoint: 'https://mosaic-foreman.example/api',
+ avatar: '/fixtures/avatars/mosaic-foreman.png'
+ },
+ {
+ id: 'evm:42161:77',
+ districtId: 'arbitrum',
+ chain: 'Arbitrum',
+ name: 'Route Prospector',
+ summary: 'Discovers resilient failover routes for agent endpoint traffic.',
+ quality: 0.87,
+ services: ['routing', 'health', 'failover'],
+ endpoint: 'https://route-prospector.example/api',
+ avatar: '/fixtures/avatars/route-prospector.png'
+ },
+ {
+ id: 'solana:devnet:214',
+ districtId: 'solana',
+ chain: 'Solana Devnet',
+ name: 'Dock Cartographer',
+ summary: 'Indexes on-chain metadata and semantic tags for storefront discovery.',
+ quality: 0.91,
+ services: ['index', 'semantic-search'],
+ endpoint: 'https://dock-cartographer.example/api',
+ avatar: '/fixtures/avatars/dock-cartographer.png'
+ },
+ {
+ id: 'solana:devnet:215',
+ districtId: 'solana',
+ chain: 'Solana Devnet',
+ name: 'Pulse Watchtower',
+ summary: 'Pings service endpoints weekly and computes uptime confidence.',
+ quality: 0.93,
+ services: ['ping', 'quality-score'],
+ endpoint: 'https://pulse-watchtower.example/api',
+ avatar: '/fixtures/avatars/pulse-watchtower.png'
+ }
+];
+
+export const LEADERBOARD_ROWS = [
+ { id: 't1', team: 'Dusty Coders', chain: 'Ethereum', referrals: 123, views: 931 },
+ { id: 't2', team: 'Mojave Agents', chain: 'Base', referrals: 96, views: 740 },
+ { id: 't3', team: 'Railroad Minds', chain: 'Solana', referrals: 72, views: 689 },
+ { id: 't4', team: 'Copper Valley', chain: 'Polygon', referrals: 48, views: 422 }
+];
+
+export const TRAINER_ATTEMPTS = [
+ { id: 'a-201', status: 'pass', score: 0.94, runAt: '2026-02-23T09:10:00Z' },
+ { id: 'a-200', status: 'pass', score: 0.91, runAt: '2026-02-23T09:02:00Z' },
+ { id: 'a-199', status: 'fail', score: 0.62, runAt: '2026-02-23T08:50:00Z' }
+];
+
+export function getDistrictById(id) {
+ return DISTRICTS.find((district) => district.id === id) || null;
+}
+
+export function getStorefrontsByDistrict(districtId) {
+ return STOREFRONTS.filter((entry) => entry.districtId === districtId);
+}
+
+export function searchStorefronts(query, districtId = '') {
+ const q = query.trim().toLowerCase();
+ return STOREFRONTS.filter((entry) => {
+ if (districtId && entry.districtId !== districtId) return false;
+ if (!q) return true;
+ return (
+ entry.name.toLowerCase().includes(q) ||
+ entry.summary.toLowerCase().includes(q) ||
+ entry.chain.toLowerCase().includes(q) ||
+ entry.services.join(' ').toLowerCase().includes(q)
+ );
+ });
+}
diff --git a/prototypes/v0-next/next.config.mjs b/prototypes/v0-next/next.config.mjs
new file mode 100644
index 0000000..7d08ffa
--- /dev/null
+++ b/prototypes/v0-next/next.config.mjs
@@ -0,0 +1,6 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+ reactStrictMode: true
+};
+
+export default nextConfig;
diff --git a/prototypes/v0-next/package-lock.json b/prototypes/v0-next/package-lock.json
new file mode 100644
index 0000000..358efa7
--- /dev/null
+++ b/prototypes/v0-next/package-lock.json
@@ -0,0 +1,427 @@
+{
+ "name": "agent-town-v0-prototype",
+ "version": "0.1.0",
+ "lockfileVersion": 3,
+ "requires": true,
+ "packages": {
+ "": {
+ "name": "agent-town-v0-prototype",
+ "version": "0.1.0",
+ "dependencies": {
+ "next": "14.2.17",
+ "react": "18.3.1",
+ "react-dom": "18.3.1"
+ }
+ },
+ "node_modules/@next/env": {
+ "version": "14.2.17",
+ "resolved": "https://registry.npmjs.org/@next/env/-/env-14.2.17.tgz",
+ "integrity": "sha512-MCgO7VHxXo8sYR/0z+sk9fGyJJU636JyRmkjc7ZJY8Hurl8df35qG5hoAh5KMs75FLjhlEo9bb2LGe89Y/scDA==",
+ "license": "MIT"
+ },
+ "node_modules/@next/swc-darwin-arm64": {
+ "version": "14.2.17",
+ "resolved": "https://registry.npmjs.org/@next/swc-darwin-arm64/-/swc-darwin-arm64-14.2.17.tgz",
+ "integrity": "sha512-WiOf5nElPknrhRMTipXYTJcUz7+8IAjOYw3vXzj3BYRcVY0hRHKWgTgQ5439EvzQyHEko77XK+yN9x9OJ0oOog==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">= 10"
+ }
+ },
+ "node_modules/@next/swc-darwin-x64": {
+ "version": "14.2.17",
+ "resolved": "https://registry.npmjs.org/@next/swc-darwin-x64/-/swc-darwin-x64-14.2.17.tgz",
+ "integrity": "sha512-29y425wYnL17cvtxrDQWC3CkXe/oRrdt8ie61S03VrpwpPRI0XsnTvtKO06XCisK4alaMnZlf8riwZIbJTaSHQ==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">= 10"
+ }
+ },
+ "node_modules/@next/swc-linux-arm64-gnu": {
+ "version": "14.2.17",
+ "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-gnu/-/swc-linux-arm64-gnu-14.2.17.tgz",
+ "integrity": "sha512-SSHLZls3ZwNEHsc+d0ynKS+7Af0Nr8+KTUBAy9pm6xz9SHkJ/TeuEg6W3cbbcMSh6j4ITvrjv3Oi8n27VR+IPw==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 10"
+ }
+ },
+ "node_modules/@next/swc-linux-arm64-musl": {
+ "version": "14.2.17",
+ "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-musl/-/swc-linux-arm64-musl-14.2.17.tgz",
+ "integrity": "sha512-VFge37us5LNPatB4F7iYeuGs9Dprqe4ZkW7lOEJM91r+Wf8EIdViWHLpIwfdDXinvCdLl6b4VyLpEBwpkctJHA==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 10"
+ }
+ },
+ "node_modules/@next/swc-linux-x64-gnu": {
+ "version": "14.2.17",
+ "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-gnu/-/swc-linux-x64-gnu-14.2.17.tgz",
+ "integrity": "sha512-aaQlpxUVb9RZ41adlTYVQ3xvYEfBPUC8+6rDgmQ/0l7SvK8S1YNJzPmDPX6a4t0jLtIoNk7j+nroS/pB4nx7vQ==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 10"
+ }
+ },
+ "node_modules/@next/swc-linux-x64-musl": {
+ "version": "14.2.17",
+ "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-musl/-/swc-linux-x64-musl-14.2.17.tgz",
+ "integrity": "sha512-HSyEiFaEY3ay5iATDqEup5WAfrhMATNJm8dYx3ZxL+e9eKv10XKZCwtZByDoLST7CyBmyDz+OFJL1wigyXeaoA==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 10"
+ }
+ },
+ "node_modules/@next/swc-win32-arm64-msvc": {
+ "version": "14.2.17",
+ "resolved": "https://registry.npmjs.org/@next/swc-win32-arm64-msvc/-/swc-win32-arm64-msvc-14.2.17.tgz",
+ "integrity": "sha512-h5qM9Btqv87eYH8ArrnLoAHLyi79oPTP2vlGNSg4CDvUiXgi7l0+5KuEGp5pJoMhjuv9ChRdm7mRlUUACeBt4w==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">= 10"
+ }
+ },
+ "node_modules/@next/swc-win32-ia32-msvc": {
+ "version": "14.2.17",
+ "resolved": "https://registry.npmjs.org/@next/swc-win32-ia32-msvc/-/swc-win32-ia32-msvc-14.2.17.tgz",
+ "integrity": "sha512-BD/G++GKSLexQjdyoEUgyo5nClU7er5rK0sE+HlEqnldJSm96CIr/+YOTT063LVTT/dUOeQsNgp5DXr86/K7/A==",
+ "cpu": [
+ "ia32"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">= 10"
+ }
+ },
+ "node_modules/@next/swc-win32-x64-msvc": {
+ "version": "14.2.17",
+ "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-14.2.17.tgz",
+ "integrity": "sha512-vkQfN1+4V4KqDibkW2q0sJ6CxQuXq5l2ma3z0BRcfIqkAMZiiW67T9yCpwqJKP68QghBtPEFjPAlaqe38O6frw==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">= 10"
+ }
+ },
+ "node_modules/@swc/counter": {
+ "version": "0.1.3",
+ "resolved": "https://registry.npmjs.org/@swc/counter/-/counter-0.1.3.tgz",
+ "integrity": "sha512-e2BR4lsJkkRlKZ/qCHPw9ZaSxc0MVUd7gtbtaB7aMvHeJVYe8sOB8DBZkP2DtISHGSku9sCK6T6cnY0CtXrOCQ==",
+ "license": "Apache-2.0"
+ },
+ "node_modules/@swc/helpers": {
+ "version": "0.5.5",
+ "resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.5.tgz",
+ "integrity": "sha512-KGYxvIOXcceOAbEk4bi/dVLEK9z8sZ0uBB3Il5b1rhfClSpcX0yfRO0KmTkqR2cnQDymwLB+25ZyMzICg/cm/A==",
+ "license": "Apache-2.0",
+ "dependencies": {
+ "@swc/counter": "^0.1.3",
+ "tslib": "^2.4.0"
+ }
+ },
+ "node_modules/busboy": {
+ "version": "1.6.0",
+ "resolved": "https://registry.npmjs.org/busboy/-/busboy-1.6.0.tgz",
+ "integrity": "sha512-8SFQbg/0hQ9xy3UNTB0YEnsNBbWfhf7RtnzpL7TkBiTBRfrQ9Fxcnz7VJsleJpyp6rVLvXiuORqjlHi5q+PYuA==",
+ "dependencies": {
+ "streamsearch": "^1.1.0"
+ },
+ "engines": {
+ "node": ">=10.16.0"
+ }
+ },
+ "node_modules/caniuse-lite": {
+ "version": "1.0.30001772",
+ "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001772.tgz",
+ "integrity": "sha512-mIwLZICj+ntVTw4BT2zfp+yu/AqV6GMKfJVJMx3MwPxs+uk/uj2GLl2dH8LQbjiLDX66amCga5nKFyDgRR43kg==",
+ "funding": [
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/browserslist"
+ },
+ {
+ "type": "tidelift",
+ "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
+ },
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/ai"
+ }
+ ],
+ "license": "CC-BY-4.0"
+ },
+ "node_modules/client-only": {
+ "version": "0.0.1",
+ "resolved": "https://registry.npmjs.org/client-only/-/client-only-0.0.1.tgz",
+ "integrity": "sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA==",
+ "license": "MIT"
+ },
+ "node_modules/graceful-fs": {
+ "version": "4.2.11",
+ "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+ "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+ "license": "ISC"
+ },
+ "node_modules/js-tokens": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+ "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+ "license": "MIT"
+ },
+ "node_modules/loose-envify": {
+ "version": "1.4.0",
+ "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",
+ "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==",
+ "license": "MIT",
+ "dependencies": {
+ "js-tokens": "^3.0.0 || ^4.0.0"
+ },
+ "bin": {
+ "loose-envify": "cli.js"
+ }
+ },
+ "node_modules/nanoid": {
+ "version": "3.3.11",
+ "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+ "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/ai"
+ }
+ ],
+ "license": "MIT",
+ "bin": {
+ "nanoid": "bin/nanoid.cjs"
+ },
+ "engines": {
+ "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+ }
+ },
+ "node_modules/next": {
+ "version": "14.2.17",
+ "resolved": "https://registry.npmjs.org/next/-/next-14.2.17.tgz",
+ "integrity": "sha512-hNo/Zy701DDO3nzKkPmsLRlDfNCtb1OJxFUvjGEl04u7SFa3zwC6hqsOUzMajcaEOEV8ey1GjvByvrg0Qr5AiQ==",
+ "deprecated": "This version has a security vulnerability. Please upgrade to a patched version. See https://nextjs.org/blog/security-update-2025-12-11 for more details.",
+ "license": "MIT",
+ "dependencies": {
+ "@next/env": "14.2.17",
+ "@swc/helpers": "0.5.5",
+ "busboy": "1.6.0",
+ "caniuse-lite": "^1.0.30001579",
+ "graceful-fs": "^4.2.11",
+ "postcss": "8.4.31",
+ "styled-jsx": "5.1.1"
+ },
+ "bin": {
+ "next": "dist/bin/next"
+ },
+ "engines": {
+ "node": ">=18.17.0"
+ },
+ "optionalDependencies": {
+ "@next/swc-darwin-arm64": "14.2.17",
+ "@next/swc-darwin-x64": "14.2.17",
+ "@next/swc-linux-arm64-gnu": "14.2.17",
+ "@next/swc-linux-arm64-musl": "14.2.17",
+ "@next/swc-linux-x64-gnu": "14.2.17",
+ "@next/swc-linux-x64-musl": "14.2.17",
+ "@next/swc-win32-arm64-msvc": "14.2.17",
+ "@next/swc-win32-ia32-msvc": "14.2.17",
+ "@next/swc-win32-x64-msvc": "14.2.17"
+ },
+ "peerDependencies": {
+ "@opentelemetry/api": "^1.1.0",
+ "@playwright/test": "^1.41.2",
+ "react": "^18.2.0",
+ "react-dom": "^18.2.0",
+ "sass": "^1.3.0"
+ },
+ "peerDependenciesMeta": {
+ "@opentelemetry/api": {
+ "optional": true
+ },
+ "@playwright/test": {
+ "optional": true
+ },
+ "sass": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/picocolors": {
+ "version": "1.1.1",
+ "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+ "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+ "license": "ISC"
+ },
+ "node_modules/postcss": {
+ "version": "8.4.31",
+ "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.31.tgz",
+ "integrity": "sha512-PS08Iboia9mts/2ygV3eLpY5ghnUcfLV/EXTOW1E2qYxJKGGBUtNjN76FYHnMs36RmARn41bC0AZmn+rR0OVpQ==",
+ "funding": [
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/postcss/"
+ },
+ {
+ "type": "tidelift",
+ "url": "https://tidelift.com/funding/github/npm/postcss"
+ },
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/ai"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "nanoid": "^3.3.6",
+ "picocolors": "^1.0.0",
+ "source-map-js": "^1.0.2"
+ },
+ "engines": {
+ "node": "^10 || ^12 || >=14"
+ }
+ },
+ "node_modules/react": {
+ "version": "18.3.1",
+ "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
+ "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==",
+ "license": "MIT",
+ "dependencies": {
+ "loose-envify": "^1.1.0"
+ },
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/react-dom": {
+ "version": "18.3.1",
+ "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz",
+ "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==",
+ "license": "MIT",
+ "dependencies": {
+ "loose-envify": "^1.1.0",
+ "scheduler": "^0.23.2"
+ },
+ "peerDependencies": {
+ "react": "^18.3.1"
+ }
+ },
+ "node_modules/scheduler": {
+ "version": "0.23.2",
+ "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz",
+ "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==",
+ "license": "MIT",
+ "dependencies": {
+ "loose-envify": "^1.1.0"
+ }
+ },
+ "node_modules/source-map-js": {
+ "version": "1.2.1",
+ "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+ "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+ "license": "BSD-3-Clause",
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/streamsearch": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/streamsearch/-/streamsearch-1.1.0.tgz",
+ "integrity": "sha512-Mcc5wHehp9aXz1ax6bZUyY5afg9u2rv5cqQI3mRrYkGC8rW2hM02jWuwjtL++LS5qinSyhj2QfLyNsuc+VsExg==",
+ "engines": {
+ "node": ">=10.0.0"
+ }
+ },
+ "node_modules/styled-jsx": {
+ "version": "5.1.1",
+ "resolved": "https://registry.npmjs.org/styled-jsx/-/styled-jsx-5.1.1.tgz",
+ "integrity": "sha512-pW7uC1l4mBZ8ugbiZrcIsiIvVx1UmTfw7UkC3Um2tmfUq9Bhk8IiyEIPl6F8agHgjzku6j0xQEZbfA5uSgSaCw==",
+ "license": "MIT",
+ "dependencies": {
+ "client-only": "0.0.1"
+ },
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "peerDependencies": {
+ "react": ">= 16.8.0 || 17.x.x || ^18.0.0-0"
+ },
+ "peerDependenciesMeta": {
+ "@babel/core": {
+ "optional": true
+ },
+ "babel-plugin-macros": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/tslib": {
+ "version": "2.8.1",
+ "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+ "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+ "license": "0BSD"
+ }
+ }
+}
diff --git a/prototypes/v0-next/package.json b/prototypes/v0-next/package.json
new file mode 100644
index 0000000..4a5d282
--- /dev/null
+++ b/prototypes/v0-next/package.json
@@ -0,0 +1,16 @@
+{
+ "name": "agent-town-v0-prototype",
+ "private": true,
+ "version": "0.1.0",
+ "description": "Next.js prototype shell for Trainer + Atlas UX iteration in v0.",
+ "scripts": {
+ "dev": "next dev -p 4300",
+ "build": "next build",
+ "start": "next start -p 4300"
+ },
+ "dependencies": {
+ "next": "14.2.17",
+ "react": "18.3.1",
+ "react-dom": "18.3.1"
+ }
+}
diff --git a/public/agent_panel.js b/public/agent_panel.js
index 8d9f3e4..b8334e8 100644
--- a/public/agent_panel.js
+++ b/public/agent_panel.js
@@ -1,8 +1,16 @@
(() => {
+ const isCeremonyEmbed = (
+ window.__agentTownCeremonyEmbed === true
+ || document.documentElement.classList.contains('ceremony-embed')
+ );
+ if (isCeremonyEmbed) return;
+
const PANEL_MINIMIZED_KEY = 'agentTown:panel:minimized';
let gateway = null;
let gatewayInitPromise = null;
let gatewayListenersBound = false;
+ let panelLayoutObserver = null;
+ let panelLayoutResizeBound = false;
function el(id) {
return document.getElementById(id);
@@ -32,6 +40,42 @@
node.textContent = text || 'Idle';
}
+ function syncPanelLayout(panel = null) {
+ const root = document.documentElement;
+ const body = document.body;
+ const dock = panel || el('agentSidebar');
+ if (!root || !body) return;
+ if (!dock || dock.classList.contains('is-hidden')) {
+ root.style.setProperty('--agent-panel-page-inset', '0px');
+ body.classList.remove('agent-panel-expanded');
+ return;
+ }
+ const insetPx = Math.max(0, Math.round(dock.getBoundingClientRect().height || 0));
+ root.style.setProperty('--agent-panel-page-inset', `${insetPx}px`);
+ body.classList.toggle('agent-panel-expanded', !dock.classList.contains('minimized'));
+ }
+
+ function bindPanelLayout(panel) {
+ if (!panel) return;
+ syncPanelLayout(panel);
+ if (typeof ResizeObserver === 'function') {
+ if (!panelLayoutObserver) {
+ panelLayoutObserver = new ResizeObserver(() => {
+ syncPanelLayout(panel);
+ });
+ } else {
+ panelLayoutObserver.disconnect();
+ }
+ panelLayoutObserver.observe(panel);
+ }
+ if (!panelLayoutResizeBound) {
+ panelLayoutResizeBound = true;
+ window.addEventListener('resize', () => {
+ syncPanelLayout(panel);
+ });
+ }
+ }
+
function appendChatMessage(role, text) {
const box = el('chatTranscript');
if (!box) return;
@@ -75,6 +119,7 @@
+
@@ -99,6 +144,7 @@
panel.classList.toggle('minimized', !!minimized);
syncMinimizeLabel();
saveMinimizedPreference(!!minimized);
+ syncPanelLayout(panel);
}
async function initGateway() {
@@ -207,6 +253,7 @@
panel.dataset.bound = '1';
setMinimized(loadMinimizedPreference());
+ bindPanelLayout(panel);
setStatus('Idle');
const header = panel.querySelector('.sidebar-header');
@@ -231,6 +278,19 @@
});
}
+ const openTrainerBtn = el('agentOpenTrainerBtn');
+ if (openTrainerBtn) {
+ openTrainerBtn.addEventListener('click', () => {
+ if (typeof window.openExperienceTrainerModal === 'function') {
+ Promise.resolve(window.openExperienceTrainerModal()).catch(() => {
+ window.location.assign('/trainer');
+ });
+ return;
+ }
+ window.location.assign('/trainer');
+ });
+ }
+
const chatInput = el('chatInput');
if (chatInput) {
chatInput.addEventListener('keydown', (event) => {
diff --git a/public/app.js b/public/app.js
index ad4c6fb..21ebbe6 100644
--- a/public/app.js
+++ b/public/app.js
@@ -1,4 +1,40 @@
const TEAM_CODE_HINT_STORAGE_KEY = 'agentTown:teamCodeHint';
+const WALLET_IDENTITY_HINT_STORAGE_KEY = 'agentTown:walletIdentityHint';
+const WALLET_IDENTITY_EVM_HEADER = 'x-wallet-evm-address';
+const WALLET_IDENTITY_SOLANA_HEADER = 'x-wallet-solana-address';
+
+const ONBOARDING_STEP_TOWNHALL = 'townhall_profile';
+const ONBOARDING_STEP_BRAIN = 'brain';
+const ONBOARDING_STEP_SIGIL = 'sigil';
+const ONBOARDING_STEP_CEREMONY = 'ceremony';
+const ONBOARDING_STEP_DONE = 'done';
+
+function normalizeOnboardingStep(value) {
+ switch (String(value || '').trim()) {
+ case ONBOARDING_STEP_TOWNHALL:
+ case ONBOARDING_STEP_BRAIN:
+ case ONBOARDING_STEP_SIGIL:
+ case ONBOARDING_STEP_CEREMONY:
+ case ONBOARDING_STEP_DONE:
+ return String(value).trim();
+ default:
+ return '';
+ }
+}
+
+function getOnboardingStep(state) {
+ const onboarding = state?.onboarding || {};
+ if (onboarding.required !== true) return ONBOARDING_STEP_DONE;
+
+ const explicitStep = normalizeOnboardingStep(onboarding.step);
+ if (explicitStep) return explicitStep;
+
+ if (onboarding.registrationComplete !== true) return ONBOARDING_STEP_TOWNHALL;
+ if (!isTownhallBrainConfigured(state)) return ONBOARDING_STEP_BRAIN;
+ if (!state?.signup?.complete) return ONBOARDING_STEP_SIGIL;
+ if (state?.houseId) return ONBOARDING_STEP_DONE;
+ return ONBOARDING_STEP_CEREMONY;
+}
function readTeamCodeHint() {
try {
@@ -18,8 +54,57 @@ function saveTeamCodeHint(value) {
}
}
+function readWalletIdentityHint() {
+ try {
+ const raw = localStorage.getItem(WALLET_IDENTITY_HINT_STORAGE_KEY);
+ if (!raw) return { evm: '', solana: '' };
+ const parsed = JSON.parse(raw);
+ const evm = normalizeEvmAddress(parsed?.evm || parsed?.evmAddress || '') || '';
+ const solana = normalizeSolanaAddress(parsed?.solana || parsed?.solanaAddress || '') || '';
+ return { evm, solana };
+ } catch {
+ return { evm: '', solana: '' };
+ }
+}
+
+function saveWalletIdentityHint(identity = {}) {
+ const current = readWalletIdentityHint();
+ const evm = normalizeEvmAddress(identity?.evm || identity?.evmAddress || current.evm || '') || '';
+ const solana = normalizeSolanaAddress(identity?.solana || identity?.solanaAddress || current.solana || '') || '';
+ try {
+ if (!evm && !solana) {
+ localStorage.removeItem(WALLET_IDENTITY_HINT_STORAGE_KEY);
+ return;
+ }
+ localStorage.setItem(WALLET_IDENTITY_HINT_STORAGE_KEY, JSON.stringify({
+ evm: evm || null,
+ solana: solana || null
+ }));
+ } catch {
+ // ignore storage errors
+ }
+}
+
+function clearWalletIdentityHint() {
+ try {
+ localStorage.removeItem(WALLET_IDENTITY_HINT_STORAGE_KEY);
+ } catch {
+ // ignore storage errors
+ }
+}
+
async function api(url, opts = {}) {
const headers = { 'content-type': 'application/json', ...(opts.headers || {}) };
+ const walletIdentities = getWalletIdentitiesForHeaders();
+ for (const { chain, address } of walletIdentities) {
+ if (chain === 'evm' && headers[WALLET_IDENTITY_EVM_HEADER] === undefined) {
+ headers[WALLET_IDENTITY_EVM_HEADER] = address;
+ continue;
+ }
+ if (chain === 'solana' && headers[WALLET_IDENTITY_SOLANA_HEADER] === undefined) {
+ headers[WALLET_IDENTITY_SOLANA_HEADER] = address;
+ }
+ }
const teamCodeHint = readTeamCodeHint();
if (
teamCodeHint
@@ -30,6 +115,7 @@ async function api(url, opts = {}) {
}
const res = await fetch(url, {
credentials: 'include',
+ cache: 'no-store',
...opts,
headers
});
@@ -47,12 +133,77 @@ async function api(url, opts = {}) {
return data;
}
+function collectWalletIdentitiesFromClient() {
+ const out = [];
+ const seen = new Set();
+
+ const add = (chain, address) => {
+ const normalizedChain = chain === 'evm' ? 'evm' : chain === 'solana' ? 'solana' : '';
+ if (!normalizedChain) return;
+
+ const normalizedAddress = normalizedChain === 'evm'
+ ? normalizeEvmAddress(address)
+ : normalizeSolanaAddress(address);
+ if (!normalizedAddress) return;
+
+ const key = `${normalizedChain}:${normalizedAddress}`;
+ if (seen.has(key)) return;
+ seen.add(key);
+ out.push({ chain: normalizedChain, address: normalizedAddress });
+ };
+
+ if (walletAddr) add('solana', walletAddr);
+
+ const cachedWallet = loadWalletCache();
+ if (cachedWallet && typeof cachedWallet.address === 'string') {
+ add('solana', cachedWallet.address);
+ }
+
+ const walletIdentityHint = readWalletIdentityHint();
+ if (walletIdentityHint.solana) add('solana', walletIdentityHint.solana);
+ if (walletIdentityHint.evm) add('evm', walletIdentityHint.evm);
+
+ if (appWalletClient && typeof appWalletClient.getAddress === 'function') {
+ try {
+ add('solana', appWalletClient.getAddress({ chain: 'solana' }));
+ } catch {
+ // ignore malformed wallet state
+ }
+ try {
+ add('evm', appWalletClient.getAddress({ chain: 'evm' }));
+ } catch {
+ // ignore malformed wallet state
+ }
+ }
+
+ return out;
+}
+
+function getWalletIdentitiesForHeaders() {
+ return collectWalletIdentitiesFromClient();
+}
+
+function getWalletIdentitiesForTownhallRegistration() {
+ const identities = collectWalletIdentitiesFromClient();
+ const out = {};
+ for (const { chain, address } of identities) {
+ out[chain] = address;
+ }
+ return out;
+}
+
function el(id) {
+ const modal = document.getElementById('districtModalBody');
+ if (modal && !modal.closest('.is-hidden')) {
+ const internal = modal.querySelector('#' + id);
+ if (internal) return internal;
+ }
return document.getElementById(id);
}
const HATCH_VISIBILITY_KEY = 'openclawLite:hatchVisible';
const AGENT_PANEL_MINIMIZED_KEY = 'agentTown:panel:minimized';
+const AGENT_PANEL_DEBUG_VISIBLE_KEY = 'agentTown:panel:debugVisible';
let elements = [];
let lastState = null;
@@ -79,6 +230,8 @@ const DEFAULT_LOCAL_LITE_LLM = Object.freeze({
model: null,
modelRef: null,
authMode: 'api-key',
+ reasoning: '',
+ useProxy: true,
credential: '',
apiKeySet: false
});
@@ -122,6 +275,23 @@ const agentDebugEvents = [];
const agentDebugTraffic = [];
let agentDebugTrafficFilter = 'all';
let agentDebugTrafficMuteDepth = 0;
+let agentPanelLayoutObserver = null;
+let agentPanelLayoutResizeBound = false;
+let trainerScriptLoadPromise = null;
+let skillActionPluginCache = {
+ activeSkillPath: '',
+ sourceUrl: '',
+ parserVersion: '',
+ actions: [],
+ usage: null,
+ loadedAtMs: 0,
+};
+let trainerNamespacePluginCache = {
+ enabled: false,
+ tools: [],
+ diagnostics: null,
+ loadedAtMs: 0,
+};
function safeSetText(elementId, value, fallback = '') {
const node = el(elementId);
if (!node) return null;
@@ -141,11 +311,7 @@ function safeSetClassList(node, className, add) {
let appPrivyConfig = null;
-let elements = [];
-let lastState = null;
-let redirecting = false;
const appWalletClient = window.initWalletClient ? window.initWalletClient() : null;
-let walletAddr = null;
let walletHouseId = null;
let walletRecovered = false;
const WALLET_STORAGE_KEY = 'agentTownWallet';
@@ -153,7 +319,6 @@ const PATH_STORAGE_KEY = 'agentTownStartRole';
const TOKEN_ERROR_KEY = 'agentTownTokenError';
const SIGNUP_COMPLETE_AT_KEY = 'agentTownSignupCompleteAt';
const SHARE_CACHE_KEY = 'agentTownShareCache';
-const LEGACY_PATH_STORAGE_KEY = 'agentTownPathMode';
const TOKEN_MINT = 'CZRsbB6BrHsAmGKeoxyfwzCyhttXvhfEukXCWnseBAGS';
const TOWNHALL_IMAGE_MAX_BYTES = 2 * 1024 * 1024;
const TOWNHALL_IMAGE_TYPES = new Set(['image/png', 'image/jpeg', 'image/webp']);
@@ -168,15 +333,18 @@ const SOLANA_WEB3_MODULE_FALLBACK_URLS = [
'https://cdn.jsdelivr.net/npm/@solana/web3.js@1.98.4/+esm',
'https://cdn.skypack.dev/@solana/web3.js@1.98.4'
];
-// startRole: 'human' | 'coop' | 'agent'
+// Single path: every session uses the in-browser worker agent.
let pathMode = 'coop';
let activeDistrict = 'house';
const districtViews = {
house: { title: 'Plan Wagons', viewPath: '/views/house.html' },
+ atlas: { title: 'Atlas Depot', viewPath: '/atlas?embed=1' },
townhall: { title: 'Town Hall', viewPath: '/views/townhall.html' },
saloon: { title: 'Saloon', viewPath: '/views/saloon.html' },
pony: { title: 'Pony Express', viewPath: '/views/pony.html' },
- leaderboard: { title: 'Town Board', viewPath: '/views/leaderboard.html' }
+ leaderboard: { title: 'Town Board', viewPath: '/views/leaderboard.html' },
+ brain: { title: 'Connect Brain', viewPath: '/views/brain.html' },
+ sigil: { title: 'Sigil Test', viewPath: '/views/sigil.html' }
};
const districtViewCache = new Map();
let currentDistrict = null;
@@ -236,12 +404,21 @@ async function ensurePrivyAuthenticatedForHub() {
const cfg = await loadPrivyConfigForApp();
if (!cfg || cfg.enabled !== true) return true;
- if (!appWalletClient) return true;
+ if (typeof window.ensurePrivyLogin !== 'function') return false;
try {
- await connectWallet({ silent: true });
+ const isLoggedIn = await window.ensurePrivyLogin({ interactive: false });
+ if (!isLoggedIn) return false;
} catch {
- // no-op; wallet actions will surface specific errors when needed.
+ return false;
+ }
+
+ if (appWalletClient) {
+ try {
+ await connectWallet({ silent: true });
+ } catch {
+ // no-op; wallet actions will surface specific errors when needed.
+ }
}
updateWalletUI();
@@ -309,6 +486,30 @@ function setWalletStatus(msg, isError = false) {
elStatus.style.color = 'var(--bad)';
}
+function loadHatchVisible() {
+ try {
+ return localStorage.getItem(HATCH_VISIBILITY_KEY) === '1';
+ } catch {
+ return false;
+ }
+}
+
+function setHatchVisible(value) {
+ const on = !!value;
+ try {
+ localStorage.setItem(HATCH_VISIBILITY_KEY, on ? '1' : '0');
+ } catch {
+ // ignore storage errors
+ }
+ applyVisibility(lastState);
+}
+
+function setHatchStatus(text) {
+ const status = el('hatchStatus');
+ if (!status) return;
+ status.textContent = text || '';
+}
+
function updateWalletUI() {
const btn = el('connectWalletBtn');
if (btn) {
@@ -342,12 +543,12 @@ function bindWalletEvents() {
// Wallet disconnected outside the app.
disconnectWallet({ fromProvider: true })
.then(() => maybeResetAfterWalletDisconnect())
- .catch(() => {});
+ .catch(() => { });
};
const onAccountChanged = (next) => {
const nextAddr = walletAddressFromEvent(next);
if (!nextAddr) {
- disconnectWallet({ fromProvider: true }).catch(() => {});
+ disconnectWallet({ fromProvider: true }).catch(() => { });
return;
}
if (walletAddr && walletAddr !== nextAddr) {
@@ -412,17 +613,12 @@ function clearWalletCache() {
}
function loadPathMode() {
- try {
- const raw = localStorage.getItem(PATH_STORAGE_KEY);
- return raw === 'human' || raw === 'coop' || raw === 'agent' ? raw : 'coop';
- } catch {
- return 'coop';
- }
+ return 'coop';
}
-function savePathMode(mode) {
+function savePathMode(_mode) {
try {
- localStorage.setItem(PATH_STORAGE_KEY, mode);
+ localStorage.setItem(PATH_STORAGE_KEY, 'coop');
} catch {
// ignore storage errors
}
@@ -444,30 +640,12 @@ function setTokenError(msg) {
}
function updatePathButtons() {
- const humanBtn = el('pathHumanBtn');
- const coopBtn = el('pathCoopBtn');
- const agentBtn = el('pathAgentBtn');
- if (humanBtn) {
- const active = pathMode === 'human';
- humanBtn.classList.toggle('primary', active);
- humanBtn.setAttribute('aria-pressed', active ? 'true' : 'false');
- }
- if (coopBtn) {
- const active = pathMode === 'coop';
- coopBtn.classList.toggle('primary', active);
- coopBtn.setAttribute('aria-pressed', active ? 'true' : 'false');
- }
- if (agentBtn) {
- const active = pathMode === 'agent';
- agentBtn.classList.toggle('primary', active);
- agentBtn.setAttribute('aria-pressed', active ? 'true' : 'false');
- }
-}
-
-function setPathMode(mode, { persist = true, refresh = true } = {}) {
- const next = mode === 'human' || mode === 'agent' || mode === 'coop' ? mode : 'coop';
- pathMode = next;
- if (persist) savePathMode(next);
+ pathMode = 'coop';
+}
+
+function setPathMode(_mode, { persist = true, refresh = true } = {}) {
+ pathMode = 'coop';
+ if (persist) savePathMode('coop');
updatePathButtons();
if (refresh && lastState) updateUI(lastState);
}
@@ -477,25 +655,53 @@ function onboardingRequired(state) {
}
function isTownhallRegistrationComplete(state) {
- return !!state?.onboarding?.registrationComplete;
+ return state?.onboarding?.registrationComplete === true;
}
function isTownhallGateLocked(state) {
if (!isTownHub) return false;
if (!state) return false;
- const hasHouse = !!(state.houseId || walletHouseId);
- return onboardingRequired(state) && !hasHouse;
+ return onboardingRequired(state) && getOnboardingStep(state) === ONBOARDING_STEP_TOWNHALL;
+}
+
+function isTownhallBrainConfigured(state) {
+ return !!(state?.lite?.llmConfigured || isLocalLiteLlmConfigured());
+}
+
+function getTownHubDistrictGateReason(state) {
+ if (!isTownHub) return null;
+ const step = getOnboardingStep(state);
+ if (step === ONBOARDING_STEP_TOWNHALL) return 'onboarding';
+ if (step === ONBOARDING_STEP_BRAIN) return 'brain';
+ if (step === ONBOARDING_STEP_SIGIL) return 'sigil';
+ return null;
+}
+
+function isTownHubDistrictGateLocked(state) {
+ return !!getTownHubDistrictGateReason(state);
+}
+
+function getTownHubDistrictGateStatusText() {
+ const reason = getTownHubDistrictGateReason(lastState);
+ if (reason === 'onboarding') return 'Town Hall is required until onboarding is complete.';
+ if (reason === 'brain') return 'A brain must be configured before continuing.';
+ if (reason === 'sigil') return 'Complete your sigil test before continuing.';
+ return '';
}
function canUseTownhallSigilFlow(state) {
if (!onboardingRequired(state)) return true;
- if (state?.houseId || walletHouseId) return true;
- return isTownhallRegistrationComplete(state);
+ const step = getOnboardingStep(state);
+ return (
+ (step === ONBOARDING_STEP_SIGIL || step === ONBOARDING_STEP_CEREMONY || step === ONBOARDING_STEP_DONE)
+ && isAnyAgentConnected(state)
+ && isTownhallBrainConfigured(state)
+ );
}
function applyDistrictHotspotLocks(state) {
if (!isTownHub) return;
- const gateLocked = isTownhallGateLocked(state);
+ const gateLocked = isTownHubDistrictGateLocked(state);
document.querySelectorAll('.townDistrictHotspot[data-district]').forEach((hotspot) => {
const district = normalizeDistrict(hotspot.getAttribute('data-district') || 'house');
const blocked = gateLocked && district !== 'townhall';
@@ -505,11 +711,12 @@ function applyDistrictHotspotLocks(state) {
}
function districtStatusText(district) {
- if (isTownhallGateLocked(lastState)) {
- if (district === 'townhall') return 'Town Hall is required until you complete onboarding and generate a house.';
- return 'Locked: finish Town Hall onboarding first.';
+ const statusText = getTownHubDistrictGateStatusText();
+ if (statusText) {
+ return `Locked: ${statusText}`;
}
if (!district) return 'Select a district on the map.';
+ if (district === 'atlas') return 'Atlas Depot selected: district map and storefront exploration.';
if (district === 'townhall') return 'Town Hall selected: identity, ceremony, and picture management.';
if (district === 'saloon') return 'Saloon selected: reserved for future menu content.';
if (district === 'pony') return 'Pony Express selected: inbox and message routing.';
@@ -518,7 +725,7 @@ function districtStatusText(district) {
}
function setActiveDistrict(district) {
- const next = district === 'townhall' || district === 'saloon' || district === 'pony' || district === 'leaderboard' || district === 'house'
+ const next = district === 'atlas' || district === 'townhall' || district === 'saloon' || district === 'pony' || district === 'leaderboard' || district === 'house'
? district
: null;
activeDistrict = next;
@@ -534,11 +741,31 @@ function setActiveDistrict(district) {
}
function normalizeDistrict(district) {
- return district === 'townhall' || district === 'saloon' || district === 'pony' || district === 'leaderboard' || district === 'house'
+ return district === 'atlas'
+ || district === 'townhall'
+ || district === 'saloon'
+ || district === 'pony'
+ || district === 'leaderboard'
+ || district === 'brain'
+ || district === 'sigil'
+ || district === 'house'
? district
: 'house';
}
+function explicitDistrictFromInput(district) {
+ return district === 'atlas'
+ || district === 'townhall'
+ || district === 'saloon'
+ || district === 'pony'
+ || district === 'leaderboard'
+ || district === 'brain'
+ || district === 'sigil'
+ || district === 'house'
+ ? district
+ : null;
+}
+
function clearTouchDistrictPrime() {
touchPrimedDistrict = null;
touchPrimedAt = 0;
@@ -571,7 +798,7 @@ function bindDistrictMapInteractions() {
return;
}
- if (isTownhallGateLocked(lastState) && district !== 'townhall') {
+ if (isTownHubDistrictGateLocked(lastState) && district !== 'townhall') {
setActiveDistrict('townhall');
ev.preventDefault();
return;
@@ -595,7 +822,7 @@ function bindDistrictMapInteractions() {
});
hotspot.addEventListener('click', () => {
- if (isTownhallGateLocked(lastState) && district !== 'townhall') {
+ if (isTownHubDistrictGateLocked(lastState) && district !== 'townhall') {
setActiveDistrict('townhall');
return;
}
@@ -630,6 +857,48 @@ function formatPublicHandle(value) {
return trimmed.startsWith('@') ? trimmed : `@${trimmed}`;
}
+function resolveSharePathFromState(state) {
+ const shareId = typeof state?.share?.id === 'string' ? state.share.id.trim() : '';
+ if (shareId) return `/s/${encodeURIComponent(shareId)}`;
+ const sharePath = typeof state?.share?.sharePath === 'string' ? state.share.sharePath.trim() : '';
+ if (sharePath.startsWith('/s/')) return sharePath;
+ return '';
+}
+
+async function lookupSharePathByHouse(houseId) {
+ const normalized = String(houseId || '').trim();
+ if (!normalized) return '';
+ try {
+ const response = await api(`/api/share/by-house/${encodeURIComponent(normalized)}`);
+ const sharePath = typeof response?.sharePath === 'string' ? response.sharePath.trim() : '';
+ return sharePath.startsWith('/s/') ? sharePath : '';
+ } catch (err) {
+ if (Number(err?.status || 0) === 404) return '';
+ throw err;
+ }
+}
+
+function routeToShareCard(sharePath) {
+ const normalized = String(sharePath || '').trim();
+ if (!normalized) return;
+ const resolved = routeToPopupMode(normalized);
+ if (resolved?.mode === 'frame') {
+ openRouteInModalFrame(resolved.url, resolved.title || 'Share Card');
+ return;
+ }
+ if (resolved?.mode === 'district') {
+ showDistrict(resolved.district);
+ return;
+ }
+ if (resolved?.mode === 'leave' && resolved.url) {
+ hideDistrict();
+ window.location.assign(resolved.url);
+ return;
+ }
+ hideDistrict();
+ window.location.assign(normalized);
+}
+
function renderTownBoard(data) {
const signups = el('townBoardSignups');
const teams = el('townBoardTeams');
@@ -880,6 +1149,7 @@ let townhallHumanCustomizeOpen = false;
let townhallAgentCustomizeOpen = false;
let townhallAwaitingContinue = false;
let townhallSigilUnlockedByContinue = false;
+let townhallRegistrationCompletedOnce = false;
function setTownhallStoryStep(step) {
const next = step === 'agent' || step === 'processing' ? step : 'human';
@@ -1367,6 +1637,7 @@ async function ensureEvmMintWallet(config) {
const address = connected?.address || appWalletClient.getAddress({ chain: 'evm' }) || null;
const normalizedAddress = normalizeEvmAddress(address || '');
if (!normalizedAddress) throw new Error('NO_EVM_ACCOUNT');
+ saveWalletIdentityHint({ evm: normalizedAddress });
let provider = connected?.provider || appWalletClient.getProvider({ chain: 'evm' });
const refreshProvider = async () => {
const refreshed = await appWalletClient.connect({ chain: 'evm' });
@@ -1420,6 +1691,7 @@ async function ensureSolanaMintWallet(config) {
updateWalletUI();
saveWalletCache();
}
+ saveWalletIdentityHint({ solana: normalizedAddress });
let provider = connected?.provider || appWalletClient.getProvider({ chain: 'solana' });
const refreshProvider = async () => {
@@ -2272,6 +2544,10 @@ async function submitTownhallRegistration() {
if (pendingTownhallAgentImage) {
payload.profile.agentAvatar.image = pendingTownhallAgentImage;
}
+ const walletIdentity = getWalletIdentitiesForTownhallRegistration();
+ if (walletIdentity && (walletIdentity.evm || walletIdentity.solana)) {
+ payload.wallet = walletIdentity;
+ }
setTownhallRegisterFeedback('Saving Town Hall registration...');
@@ -2309,11 +2585,11 @@ async function submitTownhallRegistration() {
? 'Agent Sepolia mint ID is missing.'
: e?.message === 'MISSING_ERC8004_AGENT_SOLANA_ID'
? 'Agent Solana mint ID is missing.'
- : e?.message === 'TOWNHALL_IMAGE_TOO_LARGE'
- ? 'Avatar image is too large (max 2 MB).'
- : e?.message === 'INVALID_TOWNHALL_IMAGE'
- ? 'Avatar upload must be PNG, JPG, or WebP.'
- : `Registration failed: ${e.message}`;
+ : e?.message === 'TOWNHALL_IMAGE_TOO_LARGE'
+ ? 'Avatar image is too large (max 2 MB).'
+ : e?.message === 'INVALID_TOWNHALL_IMAGE'
+ ? 'Avatar upload must be PNG, JPG, or WebP.'
+ : `Registration failed: ${e.message}`;
setTownhallRegisterFeedback(message, true);
throw new Error(message);
} finally {
@@ -2436,7 +2712,7 @@ async function mintAllTownhallIdentitiesAndRegister() {
setTownhallRegisterFeedback('Saving Town Hall registration...');
await submitTownhallRegistration();
townhallMintLastErrorStep = null;
- setTownhallRegisterFeedback('Registration complete. Click Continue to start the sigil test.');
+ setTownhallRegisterFeedback('Registration complete. Configure your brain to continue.');
} catch (err) {
townhallSigilUnlockedByContinue = false;
const raw = String(err?.message || err || 'Mint failed.');
@@ -2576,9 +2852,21 @@ function syncTownhallRegistrationUI(state) {
const profile = onboarding.profile || {};
const humanAvatar = profile.humanAvatar || {};
const agentAvatar = profile.agentAvatar || {};
+ const onboardingStep = getOnboardingStep(state);
const required = onboardingRequired(state);
- const hasHouse = !!(state?.houseId || walletHouseId);
const registrationComplete = isTownhallRegistrationComplete(state);
+ const isBrainConfigured = isTownhallBrainConfigured(state);
+ const isWorkerConnected = isAnyAgentConnected(state);
+ const canShowRegistrationPanel = !required || onboardingStep === ONBOARDING_STEP_TOWNHALL || onboardingStep === ONBOARDING_STEP_BRAIN;
+ const shouldShowSigilForOnboarding = onboardingStep === ONBOARDING_STEP_SIGIL
+ || onboardingStep === ONBOARDING_STEP_CEREMONY
+ || onboardingStep === ONBOARDING_STEP_DONE;
+ const justCompletedRegistration = required && onboardingStep === ONBOARDING_STEP_BRAIN && !townhallRegistrationCompletedOnce;
+ if (!required || onboardingStep === ONBOARDING_STEP_TOWNHALL) {
+ townhallRegistrationCompletedOnce = false;
+ } else {
+ townhallRegistrationCompletedOnce = true;
+ }
const humanNameInput = el('townhallHumanName');
syncTownhallInputValue(humanNameInput, profile.humanName || '');
@@ -2610,18 +2898,13 @@ function syncTownhallRegistrationUI(state) {
setTownhallCustomizeOpen('human', townhallHumanCustomizeOpen);
setTownhallCustomizeOpen('agent', townhallAgentCustomizeOpen);
- if (hasHouse) {
- townhallAwaitingContinue = false;
+ if (!required || shouldShowSigilForOnboarding) {
townhallSigilUnlockedByContinue = true;
- } else if (registrationComplete && !townhallAwaitingContinue) {
- townhallSigilUnlockedByContinue = true;
- } else if (!registrationComplete && required && !townhallAwaitingContinue) {
+ } else if (!registrationComplete || !isBrainConfigured || !isWorkerConnected || townhallAwaitingContinue) {
townhallSigilUnlockedByContinue = false;
- } else if (!required) {
- townhallSigilUnlockedByContinue = true;
}
- if (registrationComplete || hasHouse || townhallMintInFlight || townhallAwaitingContinue || townhallStoryStep === 'processing') {
+ if (registrationComplete || townhallMintInFlight || townhallAwaitingContinue || townhallStoryStep === 'processing') {
setTownhallStoryStep('processing');
} else if (townhallStoryStep !== 'agent') {
setTownhallStoryStep('human');
@@ -2632,14 +2915,25 @@ function syncTownhallRegistrationUI(state) {
const continueBtn = el('townhallContinueBtn');
if (continueBtn) {
- const canContinue = (registrationComplete || hasHouse) && !townhallMintInFlight;
+ const canContinue = (!required || (
+ (
+ onboardingStep === ONBOARDING_STEP_BRAIN
+ || onboardingStep === ONBOARDING_STEP_SIGIL
+ )
+ && isBrainConfigured
+ && isWorkerConnected
+ )) && !townhallMintInFlight;
continueBtn.disabled = !canContinue;
}
const gateHint = el('townHallGateHint');
if (gateHint) {
- if (hasHouse) {
- gateHint.textContent = 'House unlocked. Explore town freely.';
+ if (onboardingStep === ONBOARDING_STEP_BRAIN && !isBrainConfigured) {
+ gateHint.textContent = 'Registration complete. Configure your brain to continue.';
+ } else if (onboardingStep === ONBOARDING_STEP_BRAIN && isBrainConfigured && !isWorkerConnected) {
+ gateHint.textContent = 'Brain configured. Waiting for your worker agent to connect.';
+ } else if (onboardingStep === ONBOARDING_STEP_BRAIN) {
+ gateHint.textContent = 'Registration complete. Open the sigil screen to continue.';
} else if (registrationComplete) {
gateHint.textContent = 'Registration complete.';
} else if (required) {
@@ -2650,16 +2944,44 @@ function syncTownhallRegistrationUI(state) {
}
const canUseSigil = canUseTownhallSigilFlow(state);
- const showSigil = canUseSigil && (townhallSigilUnlockedByContinue || !required || hasHouse);
+ const showSigil = shouldShowSigilForOnboarding
+ || (canUseSigil && (townhallSigilUnlockedByContinue || !required));
const sigilFlow = el('townhallSigilFlow');
if (sigilFlow) sigilFlow.classList.toggle('is-hidden', !showSigil);
- panel.classList.toggle('is-hidden', required && registrationComplete && !hasHouse && showSigil);
+ panel.classList.toggle('is-hidden', required && !canShowRegistrationPanel && showSigil);
+
+ if (justCompletedRegistration && !townhallMintInFlight) {
+ townhallAwaitingContinue = false;
+ townhallSigilUnlockedByContinue = false;
+ hideDistrict();
+ }
bindTownhallRegistrationControls();
}
+function bindBrainDistrictControls() {
+ const continueBtn = el('brainContinueBtn');
+ if (continueBtn) {
+ const state = lastState && typeof lastState === 'object' ? lastState : null;
+ const isBrainConfigured = state ? isTownhallBrainConfigured(state) : false;
+ const isWorkerConnected = state ? isAnyAgentConnected(state) : false;
+ const isReady =
+ isBrainConfigured &&
+ isWorkerConnected;
+
+ continueBtn.disabled = !isReady;
+ continueBtn.onclick = () => {
+ hideDistrict();
+ if (typeof syncTownhallGate === 'function' && lastState) {
+ syncTownhallGate(lastState);
+ }
+ };
+ }
+}
+
function bindTownDistrictControls() {
if (lastState) syncTownhallRegistrationUI(lastState);
+ bindBrainDistrictControls();
const connectWalletBtn = el('connectWalletBtn');
if (connectWalletBtn) {
@@ -2689,19 +3011,33 @@ function bindTownDistrictControls() {
};
}
- const pathHumanBtn = el('pathHumanBtn');
- if (pathHumanBtn) {
- pathHumanBtn.onclick = () => setPathMode('human');
- }
-
- const pathCoopBtn = el('pathCoopBtn');
- if (pathCoopBtn) {
- pathCoopBtn.onclick = () => setPathMode('coop');
+ const hatchWalletCheckBtn = el('hatchWalletCheckBtn');
+ if (hatchWalletCheckBtn) {
+ hatchWalletCheckBtn.onclick = async () => {
+ hatchWalletCheckBtn.disabled = true;
+ try {
+ await runWalletProfileCheck();
+ } finally {
+ hatchWalletCheckBtn.disabled = false;
+ updateWalletUI();
+ }
+ };
}
- const pathAgentBtn = el('pathAgentBtn');
- if (pathAgentBtn) {
- pathAgentBtn.onclick = () => setPathMode('agent');
+ const workerReconnectBtn = el('workerReconnectBtn');
+ if (workerReconnectBtn) {
+ workerReconnectBtn.onclick = async () => {
+ workerReconnectBtn.disabled = true;
+ setTownhallRegisterFeedback('Reconnecting worker agent...');
+ try {
+ await connectLiteAgent();
+ requestHomeSkillStep('worker-reconnect');
+ } catch (e) {
+ setTownhallRegisterFeedback(`Worker reconnect failed: ${String(e?.message || e || 'UNKNOWN_ERROR')}`, true);
+ } finally {
+ workerReconnectBtn.disabled = false;
+ }
+ };
}
const tokenVerifyBtn = el('tokenVerifyBtn');
@@ -2767,16 +3103,63 @@ function bindTownDistrictControls() {
};
}
+ const openShareCardBtn = el('openShareCardBtn');
+ const shareCardStatus = el('shareCardStatus');
+ if (openShareCardBtn) {
+ openShareCardBtn.onclick = async () => {
+ openShareCardBtn.disabled = true;
+ if (shareCardStatus) shareCardStatus.textContent = 'Resolving share card...';
+ try {
+ let sharePath = resolveSharePathFromState(lastState);
+ const houseId = String(lastState?.houseId || walletHouseId || '').trim();
+ if (!sharePath && houseId) {
+ sharePath = await lookupSharePathByHouse(houseId);
+ }
+ if (!sharePath) {
+ sharePath = '/s/sh_missing';
+ if (shareCardStatus) {
+ shareCardStatus.textContent = 'No share yet for this house. Opening placeholder card.';
+ }
+ } else if (shareCardStatus) {
+ shareCardStatus.textContent = '';
+ }
+ routeToShareCard(sharePath);
+ } catch (err) {
+ if (shareCardStatus) {
+ shareCardStatus.textContent = `Share card unavailable: ${String(err?.message || 'UNKNOWN_ERROR')}`;
+ }
+ } finally {
+ openShareCardBtn.disabled = false;
+ }
+ };
+ }
+
const openBtn = el('openBtn');
if (openBtn) {
openBtn.onclick = async () => {
const openError = safeSetText('openError');
+ const openWaiting = el('openWaiting');
if (openError) openError.textContent = '';
try {
- await api('/api/human/open/press', {
+ const result = await api('/api/human/open/press', {
method: 'POST',
body: JSON.stringify({})
});
+ if (result?.nextUrl) {
+ const resolved = routeToPopupMode(result.nextUrl);
+ if (resolved?.mode === 'district') {
+ await showDistrict(resolved.district);
+ return;
+ }
+ if (resolved?.mode === 'frame') {
+ openRouteInModalFrame(resolved.url, resolved.title || 'Ceremony');
+ return;
+ }
+ window.location.assign(resolved?.url || result.nextUrl);
+ return;
+ }
+ if (openWaiting) openWaiting.style.display = 'inline-flex';
+ requestHomeSkillStep('human-action');
} catch (e) {
if (openError) openError.textContent = `Error: ${e.message}`;
}
@@ -2821,7 +3204,114 @@ function loadAgentPanelMinimized() {
return true;
}
}
-
+
+function loadAgentPanelDebugVisible() {
+ try {
+ const raw = localStorage.getItem(AGENT_PANEL_DEBUG_VISIBLE_KEY);
+ if (raw === null) return true;
+ return raw === '1';
+ } catch {
+ return true;
+ }
+}
+
+function getTrainerModalBackdrop() {
+ return document.getElementById('trainerModalBackdrop');
+}
+
+function isTrainerModalOpen() {
+ const backdrop = getTrainerModalBackdrop();
+ return !!backdrop && !backdrop.classList.contains('is-hidden');
+}
+
+function setTrainerModalOpen(open) {
+ const backdrop = getTrainerModalBackdrop();
+ if (!backdrop) return;
+ const nextOpen = open === true;
+ backdrop.classList.toggle('is-hidden', !nextOpen);
+ backdrop.setAttribute('aria-hidden', nextOpen ? 'false' : 'true');
+ document.body.classList.toggle('trainer-modal-open', nextOpen);
+}
+
+async function ensureTrainerScriptLoaded() {
+ if (window.__agentTownTrainerScriptLoaded === true) return;
+ if (!trainerScriptLoadPromise) {
+ trainerScriptLoadPromise = new Promise((resolve, reject) => {
+ const script = document.createElement('script');
+ script.src = '/trainer.js?v=20260222d';
+ script.async = true;
+ script.dataset.agentTownTrainer = '1';
+ script.addEventListener('load', () => {
+ window.__agentTownTrainerScriptLoaded = true;
+ resolve();
+ }, { once: true });
+ script.addEventListener('error', () => {
+ trainerScriptLoadPromise = null;
+ reject(new Error('TRAINER_SCRIPT_LOAD_FAILED'));
+ }, { once: true });
+ document.body.appendChild(script);
+ });
+ }
+ return trainerScriptLoadPromise;
+}
+
+async function openTrainerModal() {
+ const backdrop = getTrainerModalBackdrop();
+ if (!isTownHub || !backdrop) {
+ window.location.assign('/trainer');
+ return;
+ }
+
+ setTrainerModalOpen(true);
+
+ const statusLine = document.getElementById('trainerStatusLine');
+ if (statusLine && statusLine.textContent.includes('failed')) {
+ statusLine.textContent = 'Trainer loading...';
+ statusLine.style.color = 'var(--muted)';
+ }
+
+ try {
+ await initGateway();
+ await ensureTrainerScriptLoaded();
+ } catch (err) {
+ if (statusLine) {
+ statusLine.textContent = `Trainer failed to initialize: ${err?.message || 'UNKNOWN'}`;
+ statusLine.style.color = 'var(--bad)';
+ }
+ }
+}
+
+function closeTrainerModal() {
+ setTrainerModalOpen(false);
+}
+
+function bindTrainerModalInteractions() {
+ const backdrop = getTrainerModalBackdrop();
+ if (!backdrop || backdrop.dataset.bound === '1') return;
+ backdrop.dataset.bound = '1';
+
+ const closeBtn = document.getElementById('trainerModalClose');
+ if (closeBtn) {
+ closeBtn.addEventListener('click', () => {
+ closeTrainerModal();
+ });
+ }
+
+ backdrop.addEventListener('click', (event) => {
+ if (event.target === backdrop) closeTrainerModal();
+ });
+
+ document.addEventListener('keydown', (event) => {
+ if (event.key !== 'Escape') return;
+ if (!isTrainerModalOpen()) return;
+ event.preventDefault();
+ closeTrainerModal();
+ });
+
+ window.openExperienceTrainerModal = () => openTrainerModal();
+ window.closeExperienceTrainerModal = () => closeTrainerModal();
+}
+
function routeToPopupMode(rawHref) {
let parsed;
try {
@@ -2843,36 +3333,60 @@ function routeToPopupMode(rawHref) {
}
if (path === '/inbox' || path.startsWith('/inbox/')) {
return {
- mode: 'leave',
- url: `${parsed.pathname}${parsed.search}${parsed.hash}`
+ mode: 'frame',
+ url: `${parsed.pathname}${parsed.search}${parsed.hash}`,
+ title: 'Inbox'
};
}
if (path === '/create') {
+ const params = new URLSearchParams(parsed.search || '');
+ params.set('embed', '1');
+ const embedUrl = `${parsed.pathname}${params.toString() ? `?${params.toString()}` : ''}${parsed.hash}`;
return {
- mode: 'leave',
- url: `${parsed.pathname}${parsed.search}${parsed.hash}`
+ mode: 'frame',
+ url: embedUrl,
+ title: 'Ceremony'
};
}
if (path === '/claim-wallet' || path === '/claim') {
return {
- mode: 'leave',
- url: path === '/claim' ? '/claim' : '/claim-wallet'
+ mode: 'frame',
+ url: path === '/claim' ? '/claim' : '/claim-wallet',
+ title: 'Claim'
+ };
+ }
+ if (path === '/atlas') {
+ const params = new URLSearchParams(parsed.search || '');
+ params.set('embed', '1');
+ const embedUrl = `${parsed.pathname}${params.toString() ? `?${params.toString()}` : ''}${parsed.hash}`;
+ return {
+ mode: 'frame',
+ url: embedUrl,
+ title: 'Atlas Depot'
};
}
if (path === '/wall') {
return { mode: 'district', district: 'leaderboard' };
}
if (path.startsWith('/s/')) {
+ const params = new URLSearchParams(parsed.search || '');
+ params.set('embed', '1');
+ const embedUrl = `${parsed.pathname}${params.toString() ? `?${params.toString()}` : ''}${parsed.hash}`;
return {
mode: 'frame',
- url: `${parsed.pathname}${parsed.search}${parsed.hash}`,
- title: 'Share'
+ url: embedUrl,
+ title: 'Share Card'
};
}
if (path === '/house') {
return { mode: 'district', district: 'house' };
}
+ if (path === '/trainer') {
+ return isTownHub
+ ? { mode: 'trainer' }
+ : { mode: 'leave', url: '/trainer' };
+ }
return {
mode: 'leave',
@@ -2888,6 +3402,50 @@ function saveAgentPanelMinimized(minimized) {
}
}
+function saveAgentPanelDebugVisible(visible) {
+ try {
+ localStorage.setItem(AGENT_PANEL_DEBUG_VISIBLE_KEY, visible ? '1' : '0');
+ } catch {
+ // ignore storage errors
+ }
+}
+
+function syncAgentPanelLayout(panel = null) {
+ const root = document.documentElement;
+ const body = document.body;
+ const dock = panel || el('agentSidebar');
+ if (!root || !body) return;
+ if (!dock || dock.classList.contains('is-hidden')) {
+ root.style.setProperty('--agent-panel-page-inset', '0px');
+ body.classList.remove('agent-panel-expanded');
+ return;
+ }
+ const insetPx = Math.max(0, Math.round(dock.getBoundingClientRect().height || 0));
+ root.style.setProperty('--agent-panel-page-inset', `${insetPx}px`);
+ body.classList.toggle('agent-panel-expanded', !dock.classList.contains('minimized'));
+}
+
+function bindAgentPanelLayout(panel) {
+ if (!panel) return;
+ syncAgentPanelLayout(panel);
+ if (typeof ResizeObserver === 'function') {
+ if (!agentPanelLayoutObserver) {
+ agentPanelLayoutObserver = new ResizeObserver(() => {
+ syncAgentPanelLayout(panel);
+ });
+ } else {
+ agentPanelLayoutObserver.disconnect();
+ }
+ agentPanelLayoutObserver.observe(panel);
+ }
+ if (!agentPanelLayoutResizeBound) {
+ agentPanelLayoutResizeBound = true;
+ window.addEventListener('resize', () => {
+ syncAgentPanelLayout(panel);
+ });
+ }
+}
+
function setOpenError(text) {
const node = el('openError');
if (!node) return;
@@ -2934,13 +3492,143 @@ function parseAvailableSkills(skillsPrompt) {
return out;
}
-function pushAgentDebugEvent(text) {
- const line = String(text || '').trim();
- if (!line) return;
- const stamp = new Date().toISOString();
- agentDebugEvents.push(`[${stamp}] ${line}`);
- if (agentDebugEvents.length > AGENT_DEBUG_EVENT_LIMIT) {
- agentDebugEvents.splice(0, agentDebugEvents.length - AGENT_DEBUG_EVENT_LIMIT);
+function getSkillActionsPlugin() {
+ return window.AgentTownSkillActionsPlugin || null;
+}
+
+function getTrainerNamespacePlugin() {
+ return window.AgentTownTrainerNamespacePlugin || null;
+}
+
+async function readActiveSkillTextForPlugin(gatewayApi, debugApi, skillSnapshot) {
+ if (!debugApi || typeof debugApi.workspaceReadFile !== 'function') return '';
+ const activeSkillPath = String(skillSnapshot?.activeSkillPath || '').trim();
+ if (!activeSkillPath) return '';
+ const readEnvelope = await debugApi.workspaceReadFile({ path: activeSkillPath }).catch(() => null);
+ const readData = readEnvelope?.ok === true ? (readEnvelope.data || null) : null;
+ return typeof readData?.content === 'string' ? readData.content : '';
+}
+
+function getRuntimeContextForPlugin(runtimeState = null) {
+ const stateObj = runtimeState && typeof runtimeState === 'object' ? runtimeState : lastState;
+ return {
+ origin: window.location.origin,
+ teamCode: String(stateObj?.teamCode || '').trim() || null,
+ houseId: String(stateObj?.houseId || '').trim() || null,
+ };
+}
+
+function parseTranscriptDumpForPlugin(rawDump) {
+ const parsed = safeJsonParse(rawDump, null);
+ if (Array.isArray(parsed)) return parsed;
+ const lines = String(rawDump || '').split(/\r?\n/).filter((line) => line.trim().length > 0);
+ const out = [];
+ for (const line of lines) {
+ const row = safeJsonParse(line, null);
+ if (row && typeof row === 'object') out.push(row);
+ }
+ return out;
+}
+
+async function refreshSkillActionPluginCache(gatewayApi, debugApi, skillSnapshot = null) {
+ const plugin = getSkillActionsPlugin();
+ if (!plugin || typeof plugin.compileSkillActions !== 'function') {
+ skillActionPluginCache = {
+ activeSkillPath: '',
+ sourceUrl: '',
+ parserVersion: '',
+ actions: [],
+ usage: null,
+ loadedAtMs: Date.now(),
+ };
+ return skillActionPluginCache;
+ }
+
+ const snapshotEnvelope = skillSnapshot || (gatewayApi && typeof gatewayApi.skillState === 'function'
+ ? await gatewayApi.skillState().catch(() => null)
+ : null);
+ const snapshot = snapshotEnvelope?.data || snapshotEnvelope || null;
+ const activeSkillPath = String(snapshot?.activeSkillPath || '').trim();
+ const sourceUrl = String(snapshot?.sourceUrl || '').trim();
+ const skillText = await readActiveSkillTextForPlugin(gatewayApi, debugApi, snapshot);
+ const compiled = plugin.compileSkillActions(skillText || '', { source: 'agent-debug-plugin' }) || { actions: [] };
+ const actions = Array.isArray(compiled?.actions) ? compiled.actions : [];
+
+ let usage = null;
+ if (typeof plugin.summarizeTranscriptUsage === 'function' && debugApi && typeof debugApi.getTranscriptDump === 'function') {
+ const rawDump = await debugApi.getTranscriptDump().catch(() => '[]');
+ const transcript = parseTranscriptDumpForPlugin(rawDump);
+ usage = plugin.summarizeTranscriptUsage(transcript, actions, getRuntimeContextForPlugin(lastState));
+ }
+
+ skillActionPluginCache = {
+ activeSkillPath,
+ sourceUrl,
+ parserVersion: String(compiled?.parserVersion || ''),
+ source: String(compiled?.source || 'none'),
+ errors: Array.isArray(compiled?.errors) ? compiled.errors : [],
+ actions,
+ usage,
+ loadedAtMs: Date.now(),
+ };
+ return skillActionPluginCache;
+}
+
+function buildSkillActionQuickRefForChat(userText) {
+ const plugin = getSkillActionsPlugin();
+ if (!plugin || typeof plugin.buildActionQuickRef !== 'function') return '';
+ const actions = Array.isArray(skillActionPluginCache?.actions) ? skillActionPluginCache.actions : [];
+ if (!actions.length) return '';
+ return plugin.buildActionQuickRef(actions, userText, 6);
+}
+
+async function refreshTrainerNamespacePluginCache(runtimeState = null) {
+ const plugin = getTrainerNamespacePlugin();
+ if (!plugin || typeof plugin.resolveEnabled !== 'function' || typeof plugin.listTools !== 'function') {
+ trainerNamespacePluginCache = {
+ enabled: false,
+ tools: [],
+ diagnostics: null,
+ loadedAtMs: Date.now(),
+ };
+ return trainerNamespacePluginCache;
+ }
+ const stateObj = runtimeState && typeof runtimeState === 'object' ? runtimeState : lastState;
+ const runtimeFlag = stateObj?.featureFlags && typeof stateObj.featureFlags === 'object'
+ ? stateObj.featureFlags.trainerNamespace
+ : null;
+ const enabled = plugin.resolveEnabled({
+ runtimeFeatureFlag: runtimeFlag,
+ locationSearch: window.location.search,
+ }) === true;
+ const tools = enabled ? plugin.listTools({ includeAliases: false }) : [];
+ const diagnostics = enabled && typeof plugin.getDiagnostics === 'function'
+ ? plugin.getDiagnostics({})
+ : null;
+ trainerNamespacePluginCache = {
+ enabled,
+ tools: Array.isArray(tools) ? tools : [],
+ diagnostics: diagnostics && typeof diagnostics === 'object' ? diagnostics : null,
+ loadedAtMs: Date.now(),
+ };
+ return trainerNamespacePluginCache;
+}
+
+function buildTrainerNamespaceQuickRefForChat(userText) {
+ const plugin = getTrainerNamespacePlugin();
+ if (!plugin || typeof plugin.buildQuickRef !== 'function') return '';
+ const tools = Array.isArray(trainerNamespacePluginCache?.tools) ? trainerNamespacePluginCache.tools : [];
+ if (!tools.length) return '';
+ return plugin.buildQuickRef(tools, userText, 6);
+}
+
+function pushAgentDebugEvent(text) {
+ const line = String(text || '').trim();
+ if (!line) return;
+ const stamp = new Date().toISOString();
+ agentDebugEvents.push(`[${stamp}] ${line}`);
+ if (agentDebugEvents.length > AGENT_DEBUG_EVENT_LIMIT) {
+ agentDebugEvents.splice(0, agentDebugEvents.length - AGENT_DEBUG_EVENT_LIMIT);
}
}
@@ -2967,6 +3655,10 @@ function onDistrictModalLinkClick(ev) {
showDistrict(resolved.district);
return;
}
+ if (resolved.mode === 'trainer') {
+ openTrainerModal().catch(() => { });
+ return;
+ }
if (resolved.mode === 'leave') {
hideDistrict();
window.location.assign(resolved.url);
@@ -2985,6 +3677,45 @@ function setDistrictModalMode(mode) {
modal.classList.toggle('is-frame', mode === 'frame');
}
+const districtModalThemeByDistrict = {
+ house: 'house',
+ atlas: 'atlas',
+ townhall: 'townhall',
+ saloon: 'saloon',
+ pony: 'pony',
+ leaderboard: 'leaderboard',
+ brain: 'trainer',
+ sigil: 'share'
+};
+
+function setDistrictModalTheme(theme) {
+ const modal = document.querySelector('#districtModalBackdrop .districtModal');
+ if (!modal) return;
+ if (!theme) {
+ modal.removeAttribute('data-theme');
+ return;
+ }
+ modal.setAttribute('data-theme', theme);
+}
+
+function inferDistrictModalThemeFromUrl(url) {
+ let parsed;
+ try {
+ parsed = new URL(url, window.location.href);
+ } catch {
+ return 'house';
+ }
+ const path = parsed.pathname || '';
+ if (path === '/atlas') return 'atlas';
+ if (path === '/wall' || path === '/leaderboard') return 'leaderboard';
+ if (path === '/house') return 'house';
+ if (path === '/create' || path === '/claim' || path === '/claim-wallet' || path === '/trainer') return 'trainer';
+ if (path === '/pony' || path === '/inbox' || path.startsWith('/inbox/')) return 'pony';
+ if (path === '/townhall') return 'townhall';
+ if (path.startsWith('/s/')) return 'share';
+ return 'house';
+}
+
function openRouteInModalFrame(url, title) {
if (!isTownHub) return;
@@ -2996,6 +3727,7 @@ function openRouteInModalFrame(url, title) {
currentDistrict = null;
clearTownBoardPoll();
setDistrictModalMode('frame');
+ setDistrictModalTheme(inferDistrictModalThemeFromUrl(url));
if (body) {
if (modalTitle) modalTitle.textContent = safeTitle;
@@ -3030,21 +3762,28 @@ async function showDistrict(district) {
if (!isTownHub) return;
const safeDistrict = normalizeDistrict(district);
- if (isTownhallGateLocked(lastState) && safeDistrict !== 'townhall') {
+ if (isTownHubDistrictGateLocked(lastState) && safeDistrict !== 'townhall') {
setActiveDistrict('townhall');
+ const statusText = getTownHubDistrictGateStatusText();
const status = el('townSceneStatus');
- if (status) status.textContent = 'Locked: complete Town Hall onboarding first.';
+ if (status && statusText) status.textContent = `Locked: ${statusText}`;
return;
}
const currentLoad = ++lastDistrictLoad;
currentDistrict = safeDistrict;
setActiveDistrict(safeDistrict);
+ if (safeDistrict === 'atlas') {
+ openRouteInModalFrame('/atlas?embed=1', 'Atlas Depot');
+ return;
+ }
+
const modal = el('districtModalBackdrop');
const body = el('districtModalBody');
const title = el('districtModalTitle');
const cfg = districtViews[safeDistrict] || districtViews.house;
setDistrictModalMode('district');
+ setDistrictModalTheme(districtModalThemeByDistrict[safeDistrict] || 'house');
if (title) title.textContent = cfg.title;
if (modal) modal.classList.remove('is-hidden');
@@ -3059,6 +3798,17 @@ async function showDistrict(district) {
body.innerHTML = html;
if (body.classList.contains('is-loading')) body.classList.remove('is-loading');
}
+ if (safeDistrict === 'brain') {
+ try {
+ let localCfg = getLocalLiteLlm();
+ if (!localCfg?.loaded) {
+ localCfg = setLocalLiteLlm(await readLocalLiteLlmConfig());
+ }
+ applyLocalLiteLlmToInputs(localCfg);
+ } catch (err) {
+ console.warn('brain district llm hydrate skipped', err);
+ }
+ }
if (lastState) {
updateUI(lastState);
}
@@ -3086,6 +3836,7 @@ function hideDistrict() {
lastDistrictLoad += 1;
clearTouchDistrictPrime();
setDistrictModalMode('district');
+ setDistrictModalTheme(null);
if (modal) modal.classList.add('is-hidden');
if (modal) modal.setAttribute('aria-hidden', 'true');
document.body.classList.remove('district-modal-open');
@@ -3136,14 +3887,74 @@ function maskTrafficSecret(raw) {
return `${text.slice(0, 4)}…${text.slice(-3)} [redacted]`;
}
+function redactTrafficString(value) {
+ const text = String(value || '');
+ if (!text) return text;
+ if (/bearer\s+[A-Za-z0-9._~+/=-]{10,}/i.test(text)) {
+ return text.replace(/bearer\s+([A-Za-z0-9._~+/=-]{10,})/gi, (_m, token) => `Bearer ${maskTrafficSecret(token)}`);
+ }
+ if (/^ey[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/.test(text.trim())) {
+ return maskTrafficSecret(text.trim());
+ }
+ if (/sk-[A-Za-z0-9_-]{10,}/i.test(text)) {
+ return text.replace(/sk-[A-Za-z0-9_-]{10,}/gi, (match) => maskTrafficSecret(match));
+ }
+ return text;
+}
+
function sanitizeAgentTrafficValue(value, depth = 0, seen = new WeakSet()) {
if (value === null || value === undefined) return value;
if (depth > 4) return '[max-depth]';
const type = typeof value;
if (type === 'string') {
- if (value.length <= 360) return value;
- return `${value.slice(0, 360)}…(truncated ${value.length - 360} chars)`;
+ const redacted = redactTrafficString(value);
+ if (redacted.length <= 360) return redacted;
+ return `${redacted.slice(0, 360)}…(truncated ${redacted.length - 360} chars)`;
+ }
+ if (type === 'number' || type === 'boolean') return value;
+ if (type === 'bigint') return String(value);
+ if (type === 'function' || type === 'symbol' || type === 'undefined') return String(value);
+
+ if (Array.isArray(value)) {
+ const slice = value.slice(0, 30).map((entry) => sanitizeAgentTrafficValue(entry, depth + 1, seen));
+ if (value.length > slice.length) {
+ slice.push(`[${value.length - slice.length} more]`);
+ }
+ return slice;
}
+
+ if (type === 'object') {
+ if (value instanceof Date) return value.toISOString();
+ if (seen.has(value)) return '[circular]';
+ seen.add(value);
+
+ const out = {};
+ const entries = Object.entries(value);
+ const maxKeys = Math.min(entries.length, 40);
+ for (let i = 0; i < maxKeys; i += 1) {
+ const [rawKey, rawVal] = entries[i];
+ const key = String(rawKey || '');
+ if (!key) continue;
+ if (/(api[_-]?key|token|secret|password|credential|authorization)/i.test(key)) {
+ out[key] = maskTrafficSecret(rawVal);
+ continue;
+ }
+ out[key] = sanitizeAgentTrafficValue(rawVal, depth + 1, seen);
+ }
+ if (entries.length > maxKeys) {
+ out.__truncatedKeys = entries.length - maxKeys;
+ }
+ return out;
+ }
+
+ return `[${type}]`;
+}
+
+function normalizeAgentTrafficFilter(value) {
+ const raw = String(value || '').trim().toLowerCase();
+ if (raw === 'in' || raw === 'incoming') return 'in';
+ if (raw === 'out' || raw === 'outgoing') return 'out';
+ return 'all';
}
async function connectWallet({ silent = false } = {}) {
@@ -3157,14 +3968,17 @@ async function connectWallet({ silent = false } = {}) {
walletHouseId = null;
walletRecovered = false;
}
- if (type === 'number' || type === 'boolean') return value;
- if (type === 'bigint') return String(value);
- if (Array.isArray(value)) {
- const slice = value.slice(0, 30).map((entry) => sanitizeAgentTrafficValue(entry, depth + 1, seen));
- if (value.length > slice.length) {
- slice.push(`[${value.length - slice.length} more]`);
+ if (!walletHouseId) {
+ const cached = loadWalletCache();
+ if (cached && cached.address === walletAddr && cached.houseId) {
+ walletHouseId = cached.houseId;
}
}
+ updateWalletUI();
+ saveWalletCache();
+ if (lastState) {
+ updateUI(lastState);
+ }
}
async function disconnectWallet({ fromProvider = false } = {}) {
@@ -3174,41 +3988,19 @@ async function disconnectWallet({ fromProvider = false } = {}) {
} catch {
// ignore disconnect errors; we still clear local state
}
+ }
unbindWalletEvents();
walletAddr = null;
walletHouseId = null;
walletRecovered = false;
updateWalletUI();
clearWalletCache();
+ clearWalletIdentityHint();
if (lastState) updateUI(lastState);
- if (type === 'object') {
- if (value instanceof Error) {
- return {
- name: String(value.name || 'Error'),
- message: String(value.message || ''),
- };
- }
- if (seen.has(value)) return '[circular]';
- seen.add(value);
-
- const out = {};
- const entries = Object.entries(value);
- const maxKeys = Math.min(entries.length, 40);
- for (let i = 0; i < maxKeys; i += 1) {
- const [rawKey, rawVal] = entries[i];
- const key = String(rawKey || '');
- if (!key) continue;
- if (/(api[_-]?key|token|secret|password|credential|authorization)/i.test(key)) {
- out[key] = maskTrafficSecret(rawVal);
- continue;
- }
- out[key] = sanitizeAgentTrafficValue(rawVal, depth + 1, seen);
- }
- if (entries.length > maxKeys) {
- out.__truncatedKeys = entries.length - maxKeys;
- }
- return out;
+ if (fromProvider) {
+ return;
}
+}
async function resetSessionAndReload() {
try {
@@ -3232,9 +4024,13 @@ async function maybeResetAfterWalletDisconnect() {
|| (st.signup?.complete && (st.signup?.mode === 'token' || st.signup?.mode === 'claim'))
)
);
+ if (!shouldResetForState(lastState)) return;
+ await resetSessionAndReload();
+}
-function pushAgentDebugTraffic(direction, channel, payload) {
- if (agentDebugTrafficMuteDepth > 0) return;
+function pushAgentDebugTraffic(direction, channel, payload, options = {}) {
+ const ignoreMute = options && options.ignoreMute === true;
+ if (!ignoreMute && agentDebugTrafficMuteDepth > 0) return;
const dir = String(direction || '').trim().toLowerCase() === 'in' ? 'IN' : 'OUT';
const target = String(channel || '').trim() || 'unknown';
const stamp = new Date().toISOString();
@@ -3266,6 +4062,7 @@ function pushAgentDebugTraffic(direction, channel, payload) {
});
if (agentDebugTraffic.length > AGENT_DEBUG_TRAFFIC_LIMIT) {
agentDebugTraffic.splice(0, agentDebugTraffic.length - AGENT_DEBUG_TRAFFIC_LIMIT);
+ }
}
async function lookupWalletHouse(houseIdOverride = null) {
@@ -3327,6 +4124,33 @@ async function verifyTokenOwnership() {
return result;
}
+function updateAgentStatus(dotId, textId, connected, name) {
+ const dot = el(dotId);
+ const text = el(textId);
+ if (!dot || !text) return;
+ dot.className = `dot ${connected ? 'good' : ''}`;
+ text.textContent = connected ? `Agent connected${name ? `: ${name}` : ''}` : 'Agent not connected';
+}
+
+async function restoreWalletConnection() {
+ const cached = loadWalletCache();
+ if (!cached || !cached.address) return;
+ try {
+ await connectWallet({ silent: true });
+ } catch {
+ clearWalletCache();
+ updateWalletUI();
+ return;
+ }
+ if (cached.houseId) {
+ walletHouseId = cached.houseId;
+ walletRecovered = true;
+ if (lastState) updateUI({ ...lastState, houseId: cached.houseId });
+ }
+ setWalletStatus('Wallet connected.');
+ saveWalletCache();
+}
+
function setAgentTrafficFilter(value) {
agentDebugTrafficFilter = normalizeAgentTrafficFilter(value);
const buttons = Array.from(document.querySelectorAll('[data-traffic-filter]'));
@@ -3379,13 +4203,6 @@ function renderAgentTrafficCards(nowIso) {
card.dataset.direction = direction;
card.dataset.stamp = stamp;
card.dataset.epochMs = String(Date.parse(stamp) || 0);
- }
-}
-
-function renderSigils(state) {
- const grid = el('sigilGrid');
- if (!grid) return;
- grid.innerHTML = '';
const header = document.createElement('div');
header.className = 'agent-traffic-card-header';
@@ -3429,6 +4246,86 @@ function renderSigils(state) {
}
}
+function renderSigils(state) {
+ const grid = el('sigilGrid');
+ if (!grid) return;
+ grid.innerHTML = '';
+
+ const confirmedHumanSel = typeof state?.human?.selected === 'string' && state.human.selected
+ ? state.human.selected
+ : null;
+ if (confirmedHumanSel) pendingHumanSigilSelection = null;
+ const humanSel = confirmedHumanSel || pendingHumanSigilSelection || null;
+ const agentSel = state?.agent?.selected || null;
+
+ for (const item of elements) {
+ const btn = document.createElement('button');
+ btn.className = 'btn sigil';
+ btn.type = 'button';
+ btn.setAttribute('data-testid', `sigil-${item.id}`);
+ btn.dataset.elementId = item.id;
+
+ const left = document.createElement('div');
+ const icon = item.icon ? `` : '';
+ left.innerHTML = `
+ Experience Trainer
+
+
+
+
+
+
+ Attempts
+
+
+ a-201pass
+ a-200pass
+ a-199fail
+
+
+ Debug tabs
+
+ Trace
+ Tools
+ Traffic
+ Brain
+
+ Mirror of the existing trainer shell for styling experiments.
+${icon}${item.label}
click to pick
`;
+
+ const right = document.createElement('div');
+ right.style.display = 'grid';
+ right.style.gap = '6px';
+ right.style.justifyItems = 'end';
+
+ const you = document.createElement('div');
+ you.className = 'pill';
+ you.style.padding = '4px 8px';
+ you.textContent = humanSel === item.id ? 'you' : '';
+
+ const agent = document.createElement('div');
+ agent.className = 'pill';
+ agent.style.padding = '4px 8px';
+ agent.textContent = agentSel === item.id ? 'agent' : '';
+
+ right.appendChild(you);
+ right.appendChild(agent);
+ btn.appendChild(left);
+ btn.appendChild(right);
+
+ if (humanSel === item.id || agentSel === item.id) {
+ btn.classList.add('selected');
+ }
+
+ btn.addEventListener('click', async () => {
+ setOpenError('');
+ pendingHumanSigilSelection = item.id;
+ if (lastState) renderSigils(lastState);
+ try {
+ const resp = await api('/api/human/select', {
+ method: 'POST',
+ body: JSON.stringify({ elementId: item.id })
+ });
+ if (resp?.humanSelected && lastState) {
+ lastState = {
+ ...lastState,
+ human: { ...(lastState.human || {}), selected: resp.humanSelected },
+ match: resp.match || lastState.match
+ };
+ }
+ pendingHumanSigilSelection = null;
+ if (lastState) {
+ renderSigils(lastState);
+ updateMatchUi(lastState);
+ }
+ requestHomeSkillStep('human-action');
+ } catch (e) {
+ pendingHumanSigilSelection = null;
+ if (lastState) renderSigils(lastState);
+ setOpenError(`Select failed: ${e.message}`);
+ }
+ });
+
+ grid.appendChild(btn);
+ }
+}
+
async function withAgentTrafficMuted(task) {
agentDebugTrafficMuteDepth += 1;
try {
@@ -3438,6 +4335,23 @@ async function withAgentTrafficMuted(task) {
}
}
+async function withDebugTimeout(task, fallback = null, timeoutMs = 8000) {
+ let timeoutId = null;
+ const wrappedTask = typeof task === 'function' ? task() : task;
+ try {
+ return await Promise.race([
+ Promise.resolve(wrappedTask),
+ new Promise((resolve) => {
+ timeoutId = setTimeout(() => resolve(fallback), Math.max(1, Number(timeoutMs) || 8000));
+ }),
+ ]);
+ } catch {
+ return fallback;
+ } finally {
+ if (timeoutId) clearTimeout(timeoutId);
+ }
+}
+
function setAgentDebugText(id, text) {
const node = el(id);
if (!node) return;
@@ -3455,27 +4369,28 @@ function instrumentGatewayTraffic(gatewayApi) {
});
const wrapCall = (channel, fn) => {
+ const forceRecord = channel === 'gateway.send';
return (...args) => {
- pushAgentDebugTraffic('out', channel, args.length <= 1 ? args[0] : { args });
+ pushAgentDebugTraffic('out', channel, args.length <= 1 ? args[0] : { args }, { ignoreMute: forceRecord });
try {
const value = fn(...args);
if (value && typeof value.then === 'function') {
return value.then((result) => {
- pushAgentDebugTraffic('in', `${channel}.result`, result);
+ pushAgentDebugTraffic('in', `${channel}.result`, result, { ignoreMute: forceRecord });
return result;
}).catch((error) => {
pushAgentDebugTraffic('in', `${channel}.error`, {
message: String(error?.message || error || 'UNKNOWN_ERROR'),
- });
+ }, { ignoreMute: forceRecord });
throw error;
});
}
- pushAgentDebugTraffic('in', `${channel}.result`, value);
+ pushAgentDebugTraffic('in', `${channel}.result`, value, { ignoreMute: forceRecord });
return value;
} catch (error) {
pushAgentDebugTraffic('in', `${channel}.error`, {
message: String(error?.message || error || 'UNKNOWN_ERROR'),
- });
+ }, { ignoreMute: forceRecord });
throw error;
}
};
@@ -3511,6 +4426,13 @@ function setAgentDebugTab(tab) {
const active = String(panel?.dataset?.debugPanel || '') === next;
panel.classList.toggle('is-hidden', !active);
}
+
+ if (next === 'session') {
+ const node = el('agentDebugSession');
+ if (node && !String(node.textContent || '').trim()) {
+ node.textContent = 'Loading session context...';
+ }
+ }
}
function formatDebugList(prefix, values) {
@@ -3528,144 +4450,41 @@ async function refreshAgentDebugPanels(reason = 'poll') {
if (agentDebugRefreshInFlight) {
agentDebugRefreshQueued = true;
- }
-}
-
-function syncTownhallGate(state) {
- if (!isTownHub) return;
- const gateLocked = isTownhallGateLocked(state);
- applyDistrictHotspotLocks(state);
-
- const closeBtn = el('districtModalClose');
- if (closeBtn) {
- closeBtn.classList.toggle('is-hidden', gateLocked);
- closeBtn.disabled = gateLocked;
- }
-
- if (!gateLocked) return;
-
- const status = el('townSceneStatus');
- if (status) status.textContent = 'Town Hall is required until you complete onboarding and generate a house.';
-
- const backdrop = el('districtModalBackdrop');
- const modalHidden = !backdrop || backdrop.classList.contains('is-hidden');
- if (currentDistrict !== 'townhall' || modalHidden) {
- showDistrict('townhall');
- }
-}
-
-function updateUI(state) {
- lastState = state;
-
- const houseId = state.houseId || walletHouseId || null;
- const signupMode = state.signup?.mode || (state.signup?.complete ? 'agent' : null);
- if ((signupMode === 'token' || signupMode === 'claim') && pathMode !== 'human') {
- setPathMode('human', { persist: true, refresh: false });
- }
- const tokenMode = pathMode === 'human' || signupMode === 'token' || signupMode === 'claim';
-
- // Counts (optional on index)
- safeSetText('signupCount', String(state.stats?.signups ?? '—'));
-
- // Team code (fallback for older servers that still send pairCode)
- const teamCode = state.teamCode || state.pairCode || '…';
- safeSetText('teamCode', teamCode);
-
- const origin = window.location.origin;
- safeSetText(
- 'teamSnippet',
- pathMode === 'agent'
- ? `Use this base URL (${origin}) and connect with team code: ${teamCode}`
- : `Read ${origin}/skill.md and team with code: ${teamCode}`
- );
-
- const houseNavLink = el('houseNavLink');
- if (houseNavLink) {
- if (houseId) {
- houseNavLink.classList.remove('is-hidden');
- houseNavLink.href = `/house?house=${encodeURIComponent(houseId)}`;
- } else {
- houseNavLink.classList.add('is-hidden');
- houseNavLink.href = '/house';
- }
- }
- updateTownHubLinks(houseId);
- syncTownhallRegistrationUI(state);
- syncTownhallGate(state);
-
- updatePathButtons();
- safeSetText(
- 'pathNote',
- pathMode === 'human'
- ? 'Human mode: solo house (token) + wallet reconnect.'
- : pathMode === 'agent'
- ? 'Agent mode: read skill.md and connect using a team code from a human.'
- : 'Co-op mode: human + agent unlock together.'
- );
-
- // Agent status
- const connected = !!state.agent?.connected;
- updateAgentStatus('agentDot', 'agentStatusText', connected, state.agent?.name || null);
- updateAgentStatus('agentDotHouse', 'agentStatusTextHouse', connected, state.agent?.name || null);
-
- setReconnectMode({ houseReady: !!houseId, role: pathMode });
- toggleAgentOnly(pathMode !== 'human');
-
- const tokenComplete = !!state.signup?.complete && (signupMode === 'token' || signupMode === 'claim');
- const tokenCreateLink = el('tokenCreateLink');
- if (tokenCreateLink) {
- tokenCreateLink.style.display = tokenComplete ? 'inline-flex' : 'none';
- if (tokenComplete) tokenCreateLink.href = '/create?mode=token';
- }
- if (tokenComplete) {
- setTokenStatus({ active: true, good: true, text: 'Verified' });
- } else if (!tokenMode) {
- setTokenStatus({ active: false });
- }
-
- if (houseId) {
- if (tokenMode) {
- safeSetText('reconnectTitle', 'House ready');
- safeSetText('reconnectIntro', 'Your house is ready. Open it to unlock with your wallet.');
- } else if (walletRecovered) {
- safeSetText('reconnectTitle', 'Welcome back');
- safeSetText('reconnectIntro', 'We found a house for this wallet. Share this reconnect message with your agent if needed.');
- } else {
- safeSetText('reconnectTitle', 'Reconnect to House');
- safeSetText('reconnectIntro', 'Your house is ready. Share this reconnect message with your agent if needed.');
- }
- safeSetText('houseSnippet', `Read ${origin}/skill.md and reconnect to your house.`);
- const openHouseLink = el('openHouseLink');
- if (openHouseLink) openHouseLink.href = `/house?house=${encodeURIComponent(houseId)}`;
return;
}
agentDebugRefreshInFlight = true;
try {
- const gatewayApi = await initGateway();
+ const gatewayApi = await withDebugTimeout(() => initGateway(), null, 6000);
const debugApi = window.__openclawLiteTest || null;
const nowIso = new Date().toISOString();
+ let transcriptToolStats = null;
+ if (debugApi && typeof debugApi.getTranscriptToolStats === 'function') {
+ transcriptToolStats = await withDebugTimeout(() => withAgentTrafficMuted(async () => {
+ return await debugApi.getTranscriptToolStats().catch(() => null);
+ }), null, 5000);
+ }
let toolRegistry = null;
if (debugApi && typeof debugApi.getToolRegistryInfo === 'function') {
- toolRegistry = await withAgentTrafficMuted(async () => {
+ toolRegistry = await withDebugTimeout(() => withAgentTrafficMuted(async () => {
return await debugApi.getToolRegistryInfo().catch(() => null);
- });
+ }), null, 5000);
}
let skillSnapshot = null;
if (gatewayApi && typeof gatewayApi.skillState === 'function') {
- const snapshot = await withAgentTrafficMuted(async () => {
+ const snapshot = await withDebugTimeout(() => withAgentTrafficMuted(async () => {
return await gatewayApi.skillState().catch(() => null);
- });
+ }), null, 6000);
skillSnapshot = snapshot?.data || snapshot || null;
}
let promptPreview = null;
if (gatewayApi && typeof gatewayApi.systemPromptPreview === 'function') {
- const preview = await withAgentTrafficMuted(async () => {
+ const preview = await withDebugTimeout(() => withAgentTrafficMuted(async () => {
return await gatewayApi.systemPromptPreview().catch(() => null);
- });
+ }), null, 6000);
promptPreview = preview?.data || preview || null;
}
@@ -3673,12 +4492,42 @@ function updateUI(state) {
const contextPaths = Array.isArray(promptPreview?.contextFilePaths) ? promptPreview.contextFilePaths : [];
const importedPaths = Array.isArray(skillSnapshot?.importedPaths) ? skillSnapshot.importedPaths : [];
const importedFiles = Array.isArray(skillSnapshot?.importedFiles) ? skillSnapshot.importedFiles : [];
+ const skillActionPluginState = await withDebugTimeout(() => withAgentTrafficMuted(async () => {
+ return await refreshSkillActionPluginCache(gatewayApi, debugApi, skillSnapshot).catch(() => null);
+ }), null, 7000);
+ const pluginActions = Array.isArray(skillActionPluginState?.actions) ? skillActionPluginState.actions : [];
+ const pluginActionToolNames = pluginActions.map((action) => `skill_action.${action.id}`);
+ const pluginUsage = skillActionPluginState?.usage || null;
+ const trainerNamespaceState = await withDebugTimeout(() => withAgentTrafficMuted(async () => {
+ return await refreshTrainerNamespacePluginCache(lastState).catch(() => null);
+ }), null, 5000);
+ const trainerNamespaceTools = Array.isArray(trainerNamespaceState?.tools) ? trainerNamespaceState.tools : [];
+ const trainerNamespaceToolNames = trainerNamespaceTools
+ .map((row) => String(row?.name || '').trim())
+ .filter(Boolean);
+ const trainerNamespaceDiagnostics = trainerNamespaceState?.diagnostics && typeof trainerNamespaceState.diagnostics === 'object'
+ ? trainerNamespaceState.diagnostics
+ : null;
+ const trainerBudgetPerTurnRemaining = trainerNamespaceDiagnostics?.budgetRemaining?.perTurn?.remaining;
+ const trainerBudgetPerMinuteRemaining = trainerNamespaceDiagnostics?.budgetRemaining?.perMinute?.remaining;
+ const trainerPendingApprovals = Array.isArray(trainerNamespaceDiagnostics?.pendingApprovals)
+ ? trainerNamespaceDiagnostics.pendingApprovals.length
+ : 0;
+ const trainerRecentBlockCodes = Array.isArray(trainerNamespaceDiagnostics?.recentBlockCodes)
+ ? trainerNamespaceDiagnostics.recentBlockCodes
+ : [];
const toolsLines = [
`Refreshed: ${nowIso}`,
`Reason: ${reason}`,
`Worker tools count: ${Number(toolRegistry?.count || (Array.isArray(toolRegistry?.names) ? toolRegistry.names.length : 0))}`,
+ `Skill action tools (plugin): ${pluginActionToolNames.length}`,
+ `Trainer namespace tools (plugin): ${trainerNamespaceToolNames.length}`,
+ `Trainer budget per turn remaining: ${trainerBudgetPerTurnRemaining === null || trainerBudgetPerTurnRemaining === undefined ? '(n/a)' : trainerBudgetPerTurnRemaining}`,
+ `Trainer budget per minute remaining: ${trainerBudgetPerMinuteRemaining === null || trainerBudgetPerMinuteRemaining === undefined ? '(n/a)' : trainerBudgetPerMinuteRemaining}`,
formatDebugList('Tools', Array.isArray(toolRegistry?.names) ? toolRegistry.names : []),
+ formatDebugList('Skill action tools', pluginActionToolNames.slice(0, 60)),
+ formatDebugList('Trainer namespace tools', trainerNamespaceToolNames.slice(0, 60)),
'',
`Dispatch path: ${String(toolRegistry?.dispatchPath || '(unknown)')}`,
`Active tab: ${agentDebugActiveTab}`,
@@ -3702,6 +4551,28 @@ function updateUI(state) {
`Skills extracted from prompt: ${availableSkills.length}`,
...availableSkills.map((entry, idx) => `${idx + 1}. ${entry.name} @ ${entry.location}\n ${entry.description}`),
'',
+ `Skill actions extracted (plugin): ${pluginActions.length}`,
+ `Skill action parser: ${String(skillActionPluginState?.parserVersion || '(unknown)')}`,
+ `Skill action source: ${String(skillActionPluginState?.source || 'none')}`,
+ ...pluginActions.slice(0, 30).map((entry, idx) => {
+ const method = String(entry?.request?.method || 'GET');
+ const urlTemplate = String(entry?.request?.urlTemplate || '');
+ const source = String(entry?.source || 'inferred');
+ const confidence = Number(entry?.confidence || 0);
+ return `${idx + 1}. ${entry.id} [${source}, c=${confidence.toFixed(2)}] ${method} ${urlTemplate}`;
+ }),
+ '',
+ `Trainer namespace enabled (plugin): ${trainerNamespaceState?.enabled === true ? 'yes' : 'no'}`,
+ `Trainer namespace tools: ${trainerNamespaceToolNames.length}`,
+ `Trainer pending approvals: ${trainerPendingApprovals}`,
+ `Trainer recent block codes: ${trainerRecentBlockCodes.length}`,
+ ...trainerNamespaceToolNames.map((name, idx) => `${idx + 1}. ${name}`),
+ ...(trainerRecentBlockCodes.slice(0, 8).map((row, idx) => {
+ const code = String(row?.code || '');
+ const tool = String(row?.tool || '');
+ return `Block ${idx + 1}: ${code || '(none)'} @ ${tool || '(unknown)'}`;
+ })),
+ '',
formatDebugList('Prompt context files', contextPaths),
'',
'Recent worker events:',
@@ -3709,39 +4580,313 @@ function updateUI(state) {
];
setAgentDebugText('agentDebugSkill', skillLines.filter(Boolean).join('\n'));
- const shouldLoadSession =
- reason === 'manual'
- || reason === 'tab-session'
- || agentDebugActiveTab === 'session'
- || !sessionPane?.textContent;
+ const shouldLoadSession =
+ reason === 'manual'
+ || reason === 'tab-session'
+ || agentDebugActiveTab === 'session'
+ || !sessionPane?.textContent;
+
+ let workerSessionContext = null;
+ let workerSessionContextError = null;
+ if (gatewayApi && typeof gatewayApi.runtimeSessionContext === 'function') {
+ try {
+ const runtimeStateInput = lastState && typeof lastState === 'object' ? lastState : null;
+ const runtimeContextInput = {
+ origin: window.location.origin,
+ teamCode: String(lastState?.teamCode || ''),
+ houseId: String(lastState?.houseId || ''),
+ };
+ const snapshot = await withDebugTimeout(() => withAgentTrafficMuted(async () => {
+ return await gatewayApi.runtimeSessionContext({
+ runtimeContext: runtimeContextInput,
+ runtimeState: runtimeStateInput,
+ });
+ }), null, 7000);
+ workerSessionContext = snapshot?.data || snapshot || null;
+ if (!workerSessionContext) {
+ workerSessionContextError = workerSessionContextError || 'RUNTIME_SESSION_CONTEXT_TIMEOUT';
+ }
+ } catch (err) {
+ workerSessionContextError = String(err?.message || err || 'RUNTIME_SESSION_CONTEXT_FAILED');
+ }
+ } else {
+ workerSessionContextError = 'RUNTIME_SESSION_CONTEXT_UNAVAILABLE';
+ }
+
+ let transcript = null;
+ if (shouldLoadSession && debugApi && typeof debugApi.getTranscriptDump === 'function') {
+ const dumpRaw = await withDebugTimeout(() => withAgentTrafficMuted(async () => {
+ return await debugApi.getTranscriptDump().catch(() => '[]');
+ }), '[]', 6000);
+ transcript = safeJsonParse(dumpRaw, []);
+ }
+
+ const sessionHeader = {
+ refreshedAt: nowIso,
+ reason,
+ runtimeState: {
+ teamCode: String(lastState?.teamCode || ''),
+ houseId: String(lastState?.houseId || ''),
+ step: String(lastState?.experience?.step || ''),
+ nextAgentAction: String(lastState?.experience?.nextAgentAction || ''),
+ },
+ skillState: {
+ status: String(skillSnapshot?.status || ''),
+ sourceUrl: String(skillSnapshot?.sourceUrl || ''),
+ activeSkillPath: String(skillSnapshot?.activeSkillPath || ''),
+ },
+ skillActionsPlugin: {
+ parserVersion: String(skillActionPluginState?.parserVersion || ''),
+ source: String(skillActionPluginState?.source || ''),
+ actionCount: pluginActions.length,
+ notUsedActions: Array.isArray(pluginUsage?.notUsedActions) ? pluginUsage.notUsedActions : [],
+ reasonCodes: Array.isArray(pluginUsage?.reasonCodes) ? pluginUsage.reasonCodes : [],
+ },
+ trainerNamespacePlugin: {
+ enabled: trainerNamespaceState?.enabled === true,
+ toolCount: trainerNamespaceToolNames.length,
+ tools: trainerNamespaceToolNames,
+ tierPolicy: trainerNamespaceDiagnostics?.tierPolicy || null,
+ budgetRemaining: trainerNamespaceDiagnostics?.budgetRemaining || null,
+ pendingApprovals: Array.isArray(trainerNamespaceDiagnostics?.pendingApprovals)
+ ? trainerNamespaceDiagnostics.pendingApprovals
+ : [],
+ recentBlockCodes: trainerRecentBlockCodes,
+ },
+ promptContextFiles: contextPaths,
+ promptSkillsCount: availableSkills.length,
+ transcriptItems: Array.isArray(transcript) ? transcript.length : null,
+ transcriptIntegrity: {
+ toolResultCount: Number(transcriptToolStats?.toolResultCount || 0),
+ orphanToolResults: Number(transcriptToolStats?.orphanToolResults || 0),
+ duplicateToolResults: Number(transcriptToolStats?.duplicateToolResults || 0),
+ displacedToolResults: Number(transcriptToolStats?.displacedToolResults || 0),
+ },
+ workerSessionContext: {
+ sessionId: String(workerSessionContext?.sessionId || ''),
+ generatedAtMs: Number.isFinite(Number(workerSessionContext?.generatedAtMs))
+ ? Number(workerSessionContext.generatedAtMs)
+ : null,
+ lastLlmSource: String(workerSessionContext?.lastLlmInput?.source || ''),
+ promptTextChars: Number.isFinite(Number(workerSessionContext?.lastLlmInput?.promptTextChars))
+ ? Number(workerSessionContext.lastLlmInput.promptTextChars)
+ : 0,
+ },
+ workerSessionContextError: workerSessionContextError || null,
+ };
+
+ const sessionLines = [
+ JSON.stringify(sessionHeader, null, 2),
+ '',
+ 'Recent worker events:',
+ ...agentDebugEventsTail(25),
+ '',
+ 'Transcript integrity (repair-sensitive):',
+ JSON.stringify({
+ toolResultCount: Number(transcriptToolStats?.toolResultCount || 0),
+ orphanToolResults: Number(transcriptToolStats?.orphanToolResults || 0),
+ duplicateToolResults: Number(transcriptToolStats?.duplicateToolResults || 0),
+ displacedToolResults: Number(transcriptToolStats?.displacedToolResults || 0),
+ }, null, 2),
+ '',
+ 'Worker session context (authoritative for LLM input):',
+ workerSessionContext ? JSON.stringify(workerSessionContext, null, 2) : '(unavailable)',
+ workerSessionContextError ? `\nWorker session context warning: ${workerSessionContextError}` : '',
+ '',
+ 'Skill action plugin diagnostics:',
+ JSON.stringify({
+ parserVersion: String(skillActionPluginState?.parserVersion || ''),
+ source: String(skillActionPluginState?.source || ''),
+ actionCount: pluginActions.length,
+ actionTools: pluginActionToolNames,
+ usage: pluginUsage,
+ }, null, 2),
+ '',
+ 'Trainer namespace plugin diagnostics:',
+ JSON.stringify({
+ enabled: trainerNamespaceState?.enabled === true,
+ toolCount: trainerNamespaceToolNames.length,
+ tools: trainerNamespaceToolNames,
+ tierPolicy: trainerNamespaceDiagnostics?.tierPolicy || null,
+ budgetRemaining: trainerNamespaceDiagnostics?.budgetRemaining || null,
+ pendingApprovals: Array.isArray(trainerNamespaceDiagnostics?.pendingApprovals)
+ ? trainerNamespaceDiagnostics.pendingApprovals
+ : [],
+ recentBlockCodes: trainerRecentBlockCodes,
+ }, null, 2),
+ '',
+ 'Transcript dump:',
+ Array.isArray(transcript) ? JSON.stringify(transcript, null, 2) : '(refresh this tab to load transcript)',
+ '',
+ 'System prompt preview:',
+ String(promptPreview?.systemPrompt || '(unavailable)'),
+ ];
+ setAgentDebugText('agentDebugSession', sessionLines.join('\n'));
+
+ renderAgentTrafficCards(nowIso);
+ } catch (err) {
+ const message = String(err?.message || err || 'DEBUG_REFRESH_FAILED');
+ const nowIso = new Date().toISOString();
+ const fallbackLines = [
+ `Refreshed: ${nowIso}`,
+ `Reason: ${reason}`,
+ '',
+ `Debug refresh failed: ${message}`,
+ '',
+ 'If this persists, click Refresh in the debug toolbar.',
+ ];
+ setAgentDebugText('agentDebugTools', fallbackLines.join('\n'));
+ setAgentDebugText('agentDebugSkill', fallbackLines.join('\n'));
+ setAgentDebugText('agentDebugSession', fallbackLines.join('\n'));
+ } finally {
+ agentDebugRefreshInFlight = false;
+ if (agentDebugRefreshQueued) {
+ agentDebugRefreshQueued = false;
+ refreshAgentDebugPanels('queued').catch(() => { });
+ }
+ }
+}
+
+function syncTownhallGate(state) {
+ if (!isTownHub) return;
+ const gateReason = getTownHubDistrictGateReason(state);
+ const gateLocked = !!gateReason;
+ const onboardingLocked = gateReason === 'onboarding';
+ applyDistrictHotspotLocks(state);
+
+ const closeBtn = el('districtModalClose');
+ if (closeBtn) {
+ closeBtn.classList.toggle('is-hidden', onboardingLocked);
+ closeBtn.disabled = onboardingLocked;
+ }
+
+ if (!gateLocked) return;
+
+ const statusText = getTownHubDistrictGateStatusText();
+ const status = el('townSceneStatus');
+ if (status && statusText) status.textContent = statusText;
+
+ const backdrop = el('districtModalBackdrop');
+ const modalHidden = !backdrop || backdrop.classList.contains('is-hidden');
+ if (onboardingLocked && (currentDistrict !== 'townhall' || modalHidden)) {
+ showDistrict('townhall');
+ } else if (gateReason === 'brain' && (currentDistrict !== 'brain' || modalHidden)) {
+ showDistrict('brain');
+ } else if (gateReason === 'sigil' && (currentDistrict !== 'sigil' || modalHidden)) {
+ showDistrict('sigil');
+ }
+}
+
+function toggleAgentOnly(showAgentOnly) {
+ const agentMode = !!showAgentOnly;
+ const nodes = Array.from(document.querySelectorAll('.agent-only'));
+ for (const node of nodes) {
+ node.classList.toggle('is-hidden', !agentMode);
+ }
+}
+
+function setReconnectMode({ houseReady = false, role = 'human' } = {}) {
+ const hasHouse = !!houseReady;
+ const roleMode = String(role || '').trim().toLowerCase();
+ const isAgentMode = roleMode === 'agent' || roleMode === 'coop';
+ const showCoopPanels = !hasHouse;
+
+ const reconnectPanel = el('reconnectPanel');
+ const step1Panel = el('step1Panel');
+ const step2Panel = el('step2Panel');
+ const stepDivider = el('stepDivider');
+
+ if (reconnectPanel) reconnectPanel.classList.toggle('is-hidden', !hasHouse);
+ if (step1Panel) step1Panel.classList.toggle('is-hidden', !showCoopPanels);
+ if (step2Panel) step2Panel.classList.toggle('is-hidden', !showCoopPanels);
+ if (stepDivider) stepDivider.classList.toggle('is-hidden', !showCoopPanels);
+ toggleAgentOnly(isAgentMode);
+}
+
+async function updateUI(state) {
+ lastState = state;
+
+ const houseId = state.houseId || walletHouseId || null;
+ const signupMode = state.signup?.mode || (state.signup?.complete ? 'agent' : null);
+
+ // Counts (optional on index)
+ safeSetText('signupCount', String(state.stats?.signups ?? '—'));
+
+ // Team code (fallback for older servers that still send pairCode)
+ const teamCode = state.teamCode || state.pairCode || '…';
+ safeSetText('teamCode', teamCode);
+ const teamCodeRow = el('agentTeamCodeRow');
+ const teamCodeText = el('agentTeamCodeText');
+ const teamCodeSendBtn = el('agentTeamCodeSendBtn');
+ const normalizedTeamCode = readCurrentTeamCodeFromState();
+ if (teamCodeText) {
+ teamCodeText.textContent = normalizedTeamCode || 'TEAM-....-....';
+ }
+ if (teamCodeRow) {
+ teamCodeRow.classList.toggle('is-hidden', !normalizedTeamCode);
+ }
+ if (teamCodeSendBtn) {
+ teamCodeSendBtn.disabled = !normalizedTeamCode;
+ }
+
+ const origin = window.location.origin;
+ safeSetText(
+ 'teamSnippet',
+ `Worker session code: ${teamCode}`
+ );
+
+ const houseNavLink = el('houseNavLink');
+ if (houseNavLink) {
+ if (houseId) {
+ houseNavLink.classList.remove('is-hidden');
+ houseNavLink.href = `/house?house=${encodeURIComponent(houseId)}`;
+ } else {
+ houseNavLink.classList.add('is-hidden');
+ houseNavLink.href = '/house';
+ }
+ }
+ updateTownHubLinks(houseId);
+ syncTownhallRegistrationUI(state);
+ syncTownhallGate(state);
+
+ updatePathButtons();
- let transcript = null;
- if (shouldLoadSession && debugApi && typeof debugApi.getTranscriptDump === 'function') {
- const dumpRaw = await withAgentTrafficMuted(async () => {
- return await debugApi.getTranscriptDump().catch(() => '[]');
- });
- transcript = safeJsonParse(dumpRaw, []);
+ // Agent status
+ const connected = !!state.agent?.connected;
+ updateAgentStatus('agentDot', 'agentStatusText', connected, state.agent?.name || null);
+ updateAgentStatus('agentDotHouse', 'agentStatusTextHouse', connected, state.agent?.name || null);
+
+ setReconnectMode({ houseReady: !!houseId, role: 'coop' });
+ toggleAgentOnly(true);
+ updateLiteAgentStatus(state);
+ initStep2Listener();
+ initAdvancedLlmUi();
+ initAgentLlmUi();
+ syncAgentLlmUiFromPrimary();
+
+ if (houseId) {
+ if (walletRecovered) {
+ safeSetText('reconnectTitle', 'Welcome back');
+ safeSetText('reconnectIntro', 'We found a house for this wallet. Continue with your worker in this session.');
+ } else {
+ safeSetText('reconnectTitle', 'Reconnect to House');
+ safeSetText('reconnectIntro', 'Your house is ready. Continue in this town session.');
}
+ safeSetText('houseSnippet', `Reconnect worker session ${teamCode} to your house.`);
+ const openHouseLink = el('openHouseLink');
+ if (openHouseLink) openHouseLink.href = `/house?house=${encodeURIComponent(houseId)}`;
+ }
- const sessionHeader = {
- refreshedAt: nowIso,
- reason,
- runtimeState: {
- teamCode: String(lastState?.teamCode || ''),
- houseId: String(lastState?.houseId || ''),
- step: String(lastState?.experience?.step || ''),
- nextAgentAction: String(lastState?.experience?.nextAgentAction || ''),
- },
- skillState: {
- status: String(skillSnapshot?.status || ''),
- sourceUrl: String(skillSnapshot?.sourceUrl || ''),
- activeSkillPath: String(skillSnapshot?.activeSkillPath || ''),
- },
- promptContextFiles: contextPaths,
- promptSkillsCount: availableSkills.length,
- transcriptItems: Array.isArray(transcript) ? transcript.length : null,
- };
-
+ const openShareCardBtn = el('openShareCardBtn');
+ const shareCardStatus = el('shareCardStatus');
+ if (openShareCardBtn) {
+ const sharePath = resolveSharePathFromState(state);
+ openShareCardBtn.textContent = sharePath ? 'Open share card' : 'Open share card (preview)';
+ openShareCardBtn.disabled = !houseId;
+ }
+ if (shareCardStatus && !houseId) {
+ shareCardStatus.textContent = '';
+ }
const matched = !!state.match?.matched;
const matchState = el('matchState');
if (matchState) {
@@ -3755,7 +4900,7 @@ function updateUI(state) {
);
const openBtn = el('openBtn');
- if (openBtn) openBtn.disabled = !matched;
+ if (openBtn) openBtn.disabled = !matched || (!!state.signup?.complete && signupMode === 'agent');
const complete = !!state.signup?.complete && signupMode === 'agent';
const openReady = el('openReady');
@@ -3767,29 +4912,7 @@ function updateUI(state) {
// Sigils
renderSigils(state);
-
- const sessionLines = [
- JSON.stringify(sessionHeader, null, 2),
- '',
- 'Recent worker events:',
- ...agentDebugEventsTail(25),
- '',
- 'Transcript dump:',
- Array.isArray(transcript) ? JSON.stringify(transcript, null, 2) : '(refresh this tab to load transcript)',
- '',
- 'System prompt preview:',
- String(promptPreview?.systemPrompt || '(unavailable)'),
- ];
- setAgentDebugText('agentDebugSession', sessionLines.join('\n'));
-
- renderAgentTrafficCards(nowIso);
- } finally {
- agentDebugRefreshInFlight = false;
- if (agentDebugRefreshQueued) {
- agentDebugRefreshQueued = false;
- refreshAgentDebugPanels('queued').catch(() => { });
- }
- }
+ scheduleAgentDebugRefresh('state');
}
function scheduleAgentDebugRefresh(reason = 'event') {
@@ -3809,6 +4932,8 @@ function setLocalLiteLlm(config) {
const model = typeof config?.model === 'string' ? config.model.trim() : '';
const modelRef = typeof config?.modelRef === 'string' ? config.modelRef.trim() : '';
const authMode = String(config?.authMode || '').trim() === 'oauth-json' ? 'oauth-json' : 'api-key';
+ const reasoning = normalizeThinkingLevel(config?.reasoning);
+ const useProxy = config?.useProxy !== false;
const credential = typeof config?.credential === 'string' ? config.credential : '';
const configured = !!(config?.configured && provider && model && credential);
@@ -3819,6 +4944,8 @@ function setLocalLiteLlm(config) {
model: model || null,
modelRef: modelRef || (provider && model ? `${provider}/${model}` : null),
authMode,
+ reasoning,
+ useProxy,
credential,
apiKeySet: !!(credential || config?.apiKeySet)
};
@@ -4585,6 +5712,8 @@ function resolveLlmConfigFromUi() {
model: parsedModel.modelId,
modelRef: parsedModel.modelRef,
authMode: mode,
+ reasoning: normalizeThinkingLevel(el('llmThinkingInput')?.value),
+ useProxy: el('llmUseProxyInput') ? el('llmUseProxyInput').checked !== false : true,
credential
};
}
@@ -4671,7 +5800,10 @@ function buildGatewayLlmPayload(config) {
const apiOverride = String(el('llmApiInput')?.value || '').trim();
const baseUrlOverride = String(el('llmBaseUrlInput')?.value || '').trim();
- const useProxy = el('llmUseProxyInput') ? el('llmUseProxyInput').checked !== false : true;
+ const useProxy = el('llmUseProxyInput')
+ ? el('llmUseProxyInput').checked !== false
+ : config?.useProxy !== false;
+ const reasoning = normalizeThinkingLevel(el('llmThinkingInput')?.value || config?.reasoning);
return {
type: 'gateway.command.setLlmConfig',
apiKey: credential,
@@ -4680,7 +5812,7 @@ function buildGatewayLlmPayload(config) {
modelRef,
modelId: model,
baseUrl: baseUrlOverride || defaultProviderBaseUrl(provider),
- reasoning: normalizeThinkingLevel(el('llmThinkingInput')?.value),
+ reasoning,
useProxy
};
}
@@ -4979,53 +6111,7 @@ function applyVisibility(state) {
// Keep the Agent panel available on every page/state.
if (sidebar) sidebar.classList.remove('is-hidden');
-}
-
-async function connectWallet() {
- if (!window.solana) throw new Error('NO_SOLANA_WALLET');
- if (typeof window.solana.connect !== 'function') throw new Error('NO_SOLANA_WALLET');
- if (typeof window.solana.signMessage !== 'function') throw new Error('NO_SOLANA_SIGN');
-
- let resp = null;
- if (window.solana.isConnected && window.solana.publicKey) {
- wallet = window.solana;
- } else {
- resp = await window.solana.connect();
- wallet = window.solana;
- }
- const pk = resp?.publicKey || wallet?.publicKey;
- walletAddr = pk && typeof pk.toString === 'function' ? pk.toString() : null;
- if (!walletAddr) throw new Error('NO_SOLANA_PUBKEY');
- return walletAddr;
-}
-
-async function signWalletMessage(message) {
- if (!wallet) throw new Error('WALLET_NOT_CONNECTED');
- const msgBytes = new TextEncoder().encode(message);
- const resp = await wallet.signMessage(msgBytes, 'utf8');
- const sigBytes = resp?.signature || resp;
- const sigArr = normalizeSignatureBytes(sigBytes);
- if (!sigArr) throw new Error('SIGNATURE_FORMAT');
- return b64(sigArr);
-}
-
-async function lookupWalletHouse() {
- if (!walletAddr) throw new Error('WALLET_NOT_CONNECTED');
- const nonceResp = await api('/api/wallet/nonce');
- const msg = buildWalletLookupMessage({
- address: walletAddr,
- nonce: nonceResp.nonce,
- houseId: null
- });
- const signature = await signWalletMessage(msg);
- return api('/api/wallet/lookup', {
- method: 'POST',
- body: JSON.stringify({
- address: walletAddr,
- nonce: nonceResp.nonce,
- signature
- })
- });
+ syncAgentPanelLayout(sidebar);
}
async function checkWalletStep() {
@@ -5162,7 +6248,13 @@ async function bootstrapVendorRuntime() {
});
if (!manifestResp.ok) throw new Error(`MANIFEST_HTTP_${manifestResp.status}`);
const manifest = await manifestResp.json().catch(() => ({}));
- const runtimeWorkerPath = String(manifest?.entrypoints?.runtimeWorker || '/openclaw-lite/runtime-worker.js');
+ const runtimeWorkerRaw = manifest?.entrypoints?.runtimeWorker;
+ const runtimeWorkerPath =
+ typeof runtimeWorkerRaw === 'string' &&
+ runtimeWorkerRaw.startsWith('/openclaw-lite/') &&
+ !runtimeWorkerRaw.startsWith('node:')
+ ? runtimeWorkerRaw
+ : '/openclaw-lite/runtime-worker.js';
fetch(runtimeWorkerPath, {
credentials: 'include',
cache: 'no-store'
@@ -5537,6 +6629,8 @@ async function readLocalLiteLlmConfig() {
const providerRaw = typeof localCfg?.provider === 'string' ? localCfg.provider.trim() : '';
const modelRaw = typeof localCfg?.model === 'string' ? localCfg.model.trim() : '';
const modelRefRaw = typeof localCfg?.modelRef === 'string' ? localCfg.modelRef.trim() : '';
+ const reasoning = normalizeThinkingLevel(localCfg?.reasoning);
+ const useProxy = localCfg?.useProxy !== false;
const defaultProvider = providerRaw || 'openai';
const defaultModel = modelRaw || getDefaultLlmModelForProvider(defaultProvider);
const parsed = parseModelRefFromText(
@@ -5557,6 +6651,8 @@ async function readLocalLiteLlmConfig() {
modelRef,
credential,
authMode,
+ reasoning,
+ useProxy,
apiKeySet: !!credential
};
}
@@ -5567,13 +6663,21 @@ function applyLocalLiteLlmToInputs(config) {
const keyInput = el('llmKeyInput');
const authModeSel = el('llmAuthModeSelect');
const oauthInput = el('llmOauthProfileInput');
+ const thinkingInput = el('llmThinkingInput');
+ const useProxyInput = el('llmUseProxyInput');
const mode = config?.authMode === 'oauth-json' ? 'oauth-json' : 'api-key';
+ const reasoning = normalizeThinkingLevel(config?.reasoning);
if (providerSel && modelInput) {
const selected = applyLlmProviderModelSelection(config?.provider || 'openai', config?.model || '');
providerSel.value = selected.provider;
modelInput.value = selected.model;
}
+ if (thinkingInput) {
+ if (reasoning) ensureSelectOption(thinkingInput, reasoning, reasoning);
+ thinkingInput.value = reasoning || '';
+ }
+ if (useProxyInput) useProxyInput.checked = config?.useProxy !== false;
if (keyInput) keyInput.value = mode === 'api-key' ? config?.credential || '' : '';
if (authModeSel) setLlmAuthModeUI(mode);
if (oauthInput) {
@@ -5657,7 +6761,9 @@ function initStep2Listener() {
provider: config.provider,
model: config.model,
apiKey: config.credential,
- authMode: config.authMode
+ authMode: config.authMode,
+ reasoning: config.reasoning,
+ useProxy: config.useProxy
});
const localCfg = setLocalLiteLlm({
@@ -5668,6 +6774,8 @@ function initStep2Listener() {
modelRef: config.modelRef,
credential: config.credential,
authMode: config.authMode,
+ reasoning: config.reasoning,
+ useProxy: config.useProxy,
apiKeySet: true
});
clearLiteSkillLoopPause();
@@ -5748,6 +6856,8 @@ async function clearLiteLlmConfig() {
provider: null,
model: null,
modelRef: null,
+ reasoning: '',
+ useProxy: true,
credential: '',
authMode: 'api-key',
apiKeySet: false
@@ -5769,6 +6879,10 @@ async function clearLiteLlmConfig() {
modelRefInput.value = resolved.modelRef;
}
if (oauthInput) oauthInput.value = '';
+ const thinkingInput = el('llmThinkingInput');
+ if (thinkingInput) thinkingInput.value = '';
+ const useProxyInput = el('llmUseProxyInput');
+ if (useProxyInput) useProxyInput.checked = true;
if (runtimeBridge && isVendorLite(lastState)) {
await ensureVendorRuntimeBridge(lastState);
await runtimeBridge.setLlmConfig({ provider: '', model: '', apiKey: '' });
@@ -5786,7 +6900,7 @@ async function clearLiteLlmConfig() {
}
}
-function renderSigils(state) {
+function renderSigilsLegacy(state) {
const grid = el('sigilGrid');
if (!grid) return;
grid.innerHTML = '';
@@ -5973,24 +7087,59 @@ function renderCeremony(state) {
// --- Dock Minimize Logic ---
document.addEventListener('DOMContentLoaded', () => {
const btn = document.getElementById('minimizeChatBtn');
+ const debugBtn = document.getElementById('agentDebugToggleBtn');
const dock = document.getElementById('agentSidebar');
- const header = document.querySelector('.sidebar-header');
+ const header = dock ? dock.querySelector('.sidebar-header') : null;
if (dock && header && btn) {
- dock.classList.toggle('minimized', loadAgentPanelMinimized());
- btn.textContent = dock.classList.contains('minimized') ? '□' : '_';
-
- header.addEventListener('click', () => {
- // Toggle minimize
- dock.classList.toggle('minimized');
- const isMin = dock.classList.contains('minimized');
- saveAgentPanelMinimized(isMin);
- btn.textContent = isMin ? '□' : '_';
+ const applyMinimized = (minimized) => {
+ dock.classList.toggle('minimized', minimized);
+ btn.textContent = minimized ? '□' : '_';
+ btn.title = minimized ? 'Expand panel' : 'Minimize panel';
+ saveAgentPanelMinimized(minimized);
+ syncAgentPanelLayout(dock);
+ };
+
+ const applyDebugVisible = (visible) => {
+ if (!debugBtn) return;
+ dock.classList.toggle('debug-collapsed', !visible);
+ debugBtn.setAttribute('aria-expanded', visible ? 'true' : 'false');
+ debugBtn.title = visible ? 'Hide debug panel' : 'Show debug panel';
+ saveAgentPanelDebugVisible(visible);
+ syncAgentPanelLayout(dock);
+ if (visible) {
+ scheduleAgentDebugRefresh('debug-open');
+ }
+ };
+
+ applyMinimized(loadAgentPanelMinimized());
+ if (debugBtn) {
+ applyDebugVisible(loadAgentPanelDebugVisible());
+ }
+ bindAgentPanelLayout(dock);
+
+ btn.addEventListener('click', (event) => {
+ event.preventDefault();
+ event.stopPropagation();
+ applyMinimized(!dock.classList.contains('minimized'));
+ });
+
+ if (debugBtn) {
+ debugBtn.addEventListener('click', (event) => {
+ event.preventDefault();
+ event.stopPropagation();
+ applyDebugVisible(dock.classList.contains('debug-collapsed'));
+ });
+ }
+
+ header.addEventListener('click', (event) => {
+ if (event.target && event.target.closest('button')) return;
+ applyMinimized(!dock.classList.contains('minimized'));
});
}
});
-function updateUI(state) {
+function updateUILegacy(state) {
lastState = state;
elements = Array.isArray(state?.elements) ? state.elements : elements;
if (!isVendorLite(state)) {
@@ -6059,11 +7208,11 @@ function updateUI(state) {
}
const liteActive = isLiteAgentActive(state);
- if (step1) {
- if (agentConnected || walletAddr || localLlm.configured) {
- step1.classList.add('done');
- } else {
- step1.classList.remove('done');
+ if (step1) {
+ if (agentConnected || walletAddr || localLlm.configured) {
+ step1.classList.add('done');
+ } else {
+ step1.classList.remove('done');
}
}
@@ -6297,13 +7446,24 @@ async function handleChat() {
if (!gateway) await initGateway();
try {
+ let outgoingText = text;
if (isVendorLite(lastState)) {
await ensureDefaultLiteSkillImported(lastState);
await refreshLiteSkillState({ force: false });
+ await refreshSkillActionPluginCache(gateway, window.__openclawLiteTest || null).catch(() => null);
+ await refreshTrainerNamespacePluginCache(lastState).catch(() => null);
+ const quickRef = buildSkillActionQuickRefForChat(text);
+ const trainerQuickRef = buildTrainerNamespaceQuickRefForChat(text);
+ if (quickRef) {
+ outgoingText = `${text}\n\n${quickRef}\nUse these action definitions when selecting http_request calls.`;
+ }
+ if (trainerQuickRef) {
+ outgoingText = `${outgoingText}\n\n${trainerQuickRef}\nUse trainer namespace tools for diagnostics before claiming completion.`;
+ }
}
await gateway.send({
type: 'chat',
- text,
+ text: outgoingText,
runtimeContext: {
origin: window.location.origin,
teamCode: String(lastState?.teamCode || ''),
@@ -6406,6 +7566,7 @@ function setupAgentInterface() {
const visitBtn = el('visitBtn');
const sendBtn = el('sendChatBtn');
const newSessionBtn = el('newSessionBtn');
+ const openTrainerBtn = el('agentOpenTrainerBtn');
const teamCodeSendBtn = el('agentTeamCodeSendBtn');
const chatInput = el('chatInput');
@@ -6414,6 +7575,13 @@ function setupAgentInterface() {
if (newSessionBtn) newSessionBtn.addEventListener('click', () => {
handleNewSession().catch(() => { });
});
+ if (openTrainerBtn) {
+ openTrainerBtn.addEventListener('click', () => {
+ openTrainerModal().catch(() => {
+ window.location.assign('/trainer');
+ });
+ });
+ }
if (teamCodeSendBtn) {
teamCodeSendBtn.addEventListener('click', () => {
sendCurrentTeamCodeToAgent().catch(() => { });
@@ -6441,7 +7609,102 @@ async function poll() {
}
}
+async function bootstrapInitialRouteState() {
+ const params = new URLSearchParams(window.location.search);
+ const ref = params.get('ref');
+ if (ref) {
+ try {
+ await api('/api/referral', { method: 'POST', body: JSON.stringify({ shareId: ref }) });
+ } catch {
+ // ignore invalid referral
+ }
+ params.delete('ref');
+ const qs = params.toString();
+ const nextUrl = `${window.location.pathname}${qs ? `?${qs}` : ''}`;
+ window.history.replaceState({}, '', nextUrl);
+ }
+
+ const tokenErr = loadTokenError();
+ const districtParam = params.get('district');
+ const pathDistrict = popupDistrictByPath[window.location.pathname] || null;
+ const explicitDistrict = explicitDistrictFromInput(districtParam) || explicitDistrictFromInput(pathDistrict);
+ pathMode = loadPathMode();
+ const initialDistrict = explicitDistrict;
+ activeDistrict = initialDistrict;
+ updatePathButtons();
+ setActiveDistrict(initialDistrict);
+
+ if (isTownHub) {
+ bindDistrictMapInteractions();
+ bindTrainerModalInteractions();
+
+ const closeBtn = el('districtModalClose');
+ if (closeBtn) {
+ closeBtn.addEventListener('click', () => hideDistrict());
+ }
+
+ const backdrop = el('districtModalBackdrop');
+ if (backdrop) {
+ backdrop.addEventListener('click', (ev) => {
+ if (ev.target === backdrop) hideDistrict();
+ });
+ }
+
+ const modalBody = el('districtModalBody');
+ if (modalBody) {
+ modalBody.addEventListener('click', onDistrictModalLinkClick);
+ }
+ }
+
+ const canRun = await ensurePrivyAuthenticatedForHub();
+ if (!canRun) {
+ if (window.location.pathname === '/app') {
+ window.location.replace('/start');
+ }
+ return;
+ }
+
+ await restoreWalletConnection();
+
+ try {
+ const session = await api('/api/session');
+ elements = Array.isArray(session?.elements) ? session.elements : [];
+ updateUI({
+ teamCode: session.teamCode,
+ elements,
+ agent: { connected: false },
+ human: {},
+ match: { matched: false },
+ signup: { complete: false, mode: null },
+ share: { id: null },
+ onboarding: session.onboarding || {
+ required: false,
+ registrationComplete: true,
+ step: ONBOARDING_STEP_DONE
+ },
+ stats: session.stats
+ });
+ } catch {
+ // continue with the full /api/state load below
+ }
+
+ if (isTownHub && initialDistrict) {
+ await showDistrict(activeDistrict);
+ }
+
+ if (tokenErr) {
+ setTokenError(tokenErr);
+ }
+
+ updateWalletUI();
+}
+
async function init() {
+ await bootstrapInitialRouteState();
+
+ // Keep agent/debug controls interactive even if runtime bootstrap stalls.
+ setupAgentInterface();
+
const enterBtn = el('enterBtn');
const connectWalletHeroBtn = el('connectWalletHeroBtn');
const authSigninBtn = el('authSigninBtn');
@@ -6558,91 +7821,14 @@ async function init() {
}
updateUI(initial);
if (isVendorLite(initial)) {
- await bootstrapVendorRuntime();
- await restoreLiteLlmConfigFromLocalIfNeeded(initial);
- }
-
- // Do not auto-load server-side Codex profile credentials. Users configure LLM credentials themselves.
-
- setupAgentInterface();
-=======
-async function init() {
- const params = new URLSearchParams(window.location.search);
- const ref = params.get('ref');
- if (ref) {
- try {
- await api('/api/referral', { method: 'POST', body: JSON.stringify({ shareId: ref }) });
- } catch {
- // ignore invalid referral
- }
- params.delete('ref');
- const qs = params.toString();
- const nextUrl = `${window.location.pathname}${qs ? `?${qs}` : ''}`;
- window.history.replaceState({}, '', nextUrl);
- }
-
- const tokenErr = loadTokenError();
- const modeParam = params.get('mode');
- const districtParam = params.get('district');
- pathMode = (modeParam === 'human' || modeParam === 'coop' || modeParam === 'agent')
- ? modeParam
- : loadPathMode();
- const initialDistrict = normalizeDistrict(districtParam || 'house');
- activeDistrict = initialDistrict;
- updatePathButtons();
- setActiveDistrict(initialDistrict);
-
- if (isTownHub) {
- bindDistrictMapInteractions();
-
- const closeBtn = el('districtModalClose');
- if (closeBtn) {
- closeBtn.addEventListener('click', () => hideDistrict());
- }
-
- const backdrop = el('districtModalBackdrop');
- if (backdrop) {
- backdrop.addEventListener('click', (ev) => {
- if (ev.target === backdrop) hideDistrict();
+ bootstrapVendorRuntime()
+ .then(() => restoreLiteLlmConfigFromLocalIfNeeded(initial))
+ .catch((error) => {
+ console.warn('vendor runtime bootstrap failed during init', error);
});
- }
-
- const modalBody = el('districtModalBody');
- if (modalBody) {
- modalBody.addEventListener('click', onDistrictModalLinkClick);
- }
- }
-
- const canRun = await ensurePrivyAuthenticatedForHub();
- if (!canRun) return;
-
- const session = await api('/api/session');
- elements = session.elements || [];
- // Update UI quickly using /api/state next.
- updateUI({
- teamCode: session.teamCode,
- elements,
- agent: { connected: false },
- human: {},
- match: { matched: false },
- signup: { complete: false, mode: null },
- share: { id: null },
- onboarding: session.onboarding || { required: false, registrationComplete: true },
- stats: session.stats
- });
-
- if (isTownHub) {
- await showDistrict(activeDistrict);
- }
-
- if (tokenErr) {
- setPathMode('human', { persist: true, refresh: true });
- setTokenError(tokenErr);
- setTokenStatus({ active: true, good: false, text: 'Verify wallet to continue' });
}
- updateWalletUI();
- restoreWalletConnection();
+ // Do not auto-load server-side Codex profile credentials. Users configure LLM credentials themselves.
poll();
}
diff --git a/public/atlas.html b/public/atlas.html
new file mode 100644
index 0000000..c8068e2
--- /dev/null
+++ b/public/atlas.html
@@ -0,0 +1,202 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/atlas.js b/public/atlas.js
new file mode 100644
index 0000000..73c96b2
--- /dev/null
+++ b/public/atlas.js
@@ -0,0 +1,1209 @@
+async function api(url, opts = {}) {
+ const headers = { 'content-type': 'application/json', ...(opts.headers || {}) };
+ const res = await fetch(url, { credentials: 'include', ...opts, headers });
+ const data = await res.json().catch(() => ({}));
+ if (!res.ok) {
+ const msg = data && data.error ? data.error : `HTTP_${res.status}`;
+ throw new Error(msg);
+ }
+ return data;
+}
+
+function el(id) { return document.getElementById(id); }
+const EMBED_MODE = new URLSearchParams(window.location.search).get('embed') === '1';
+if (EMBED_MODE) {
+ document.body.classList.add('atlas-embed');
+}
+
+const DISTRICT_POSITION_PRESETS = Object.freeze({
+ ethereum: [52, 42],
+ monad: [30, 26],
+ base: [72, 24],
+ gnosis: [33, 66],
+ bsc: [70, 62],
+ arbitrum: [82, 47],
+ optimism: [20, 52],
+ polygon: [52, 75],
+ celo: [16, 76],
+ avalanche: [78, 79],
+ scroll: [64, 42],
+ linea: [60, 35],
+ mantle: [76, 38],
+ metis: [41, 34],
+ taiko: [57, 54],
+ abstract: [44, 58],
+ megaeth: [45, 20],
+ 'x-layer': [61, 67]
+});
+
+const state = {
+ districts: [],
+ districtMap: new Map(),
+ districtDetailCache: new Map(),
+ agentsById: new Map(),
+ searchRequestSeq: 0,
+ storefrontAgentId: null,
+ currentQuery: '',
+ currentFamily: '',
+ currentSearchOpts: {
+ searchType: 'keyword',
+ sortField: 'relevance',
+ sortDirection: 'desc',
+ hasWeb: null,
+ hasMcp: null,
+ hasA2a: null,
+ active: null
+ },
+ selectedDistrictKey: null,
+ workerPollTimer: null
+};
+
+function parseBoolQueryParam(raw) {
+ const text = String(raw ?? '').trim().toLowerCase();
+ if (!text) return null;
+ if (['1', 'true', 'yes', 'on'].includes(text)) return true;
+ if (['0', 'false', 'no', 'off'].includes(text)) return false;
+ return null;
+}
+
+function normalizeSearchType(raw) {
+ return String(raw || '').trim().toLowerCase() === 'semantic' ? 'semantic' : 'keyword';
+}
+
+function normalizeSortField(raw) {
+ const value = String(raw || '').trim();
+ if (value === 'updatedAt' || value === 'name' || value === 'score') return value;
+ return 'relevance';
+}
+
+function normalizeSortDirection(raw) {
+ return String(raw || '').trim().toLowerCase() === 'asc' ? 'asc' : 'desc';
+}
+
+function loadHouseIdFromCache() {
+ try {
+ const raw = localStorage.getItem('agentTownWallet');
+ if (!raw) return null;
+ const data = JSON.parse(raw);
+ if (data && typeof data.houseId === 'string' && data.houseId) return data.houseId;
+ return null;
+ } catch {
+ return null;
+ }
+}
+
+async function resolveCurrentHouseId() {
+ const cached = loadHouseIdFromCache();
+ if (cached) return cached;
+ try {
+ const st = await api('/api/state');
+ return st.houseId || null;
+ } catch {
+ return null;
+ }
+}
+
+async function initHouseNavLink() {
+ const link = el('houseNavLink');
+ if (!link) return;
+ const houseId = await resolveCurrentHouseId();
+ if (houseId) {
+ link.classList.remove('is-hidden');
+ link.href = `/house?house=${encodeURIComponent(houseId)}`;
+ } else {
+ link.classList.add('is-hidden');
+ link.href = '/house';
+ }
+}
+
+function districtMatchesFilter(district, query, family) {
+ const q = (query || '').trim().toLowerCase();
+ const familyMatch = !family || district.key === family;
+ if (!familyMatch) return false;
+ if (!q) return true;
+ return district.key.toLowerCase().includes(q) || String(district.label || '').toLowerCase().includes(q);
+}
+
+function setUrlState({ district = null, agent = null } = {}) {
+ const next = new URL(window.location.href);
+ if (district == null) next.searchParams.delete('district');
+ else next.searchParams.set('district', district);
+ if (agent == null) next.searchParams.delete('agent');
+ else next.searchParams.set('agent', agent);
+ window.history.replaceState({}, '', next.toString());
+}
+
+function mapAgentError(error) {
+ const msg = String(error?.message || '');
+ if (msg === 'NOT_FOUND') return 'Agent not found in current atlas source.';
+ if (msg === 'DISTRICT_NOT_FOUND') return 'District not found in current atlas source.';
+ return `Error: ${msg || 'UNKNOWN'}`;
+}
+
+function setAtlasError(message) {
+ const node = el('atlasErr');
+ if (node) node.textContent = String(message || '');
+}
+
+function clearAtlasError() {
+ setAtlasError('');
+}
+
+function upsertAgents(agents) {
+ for (const agent of agents || []) {
+ if (!agent || typeof agent !== 'object') continue;
+ const id = String(agent.erc8004Id || '').trim();
+ if (!id) continue;
+ state.agentsById.set(id, agent);
+ }
+}
+
+function formatNumber(value) {
+ const n = Number(value);
+ if (!Number.isFinite(n)) return '0';
+ return Math.max(0, Math.trunc(n)).toLocaleString();
+}
+
+function initialsFromAgent(agent) {
+ const raw = String(agent?.name || agent?.erc8004Id || '?').trim();
+ if (!raw) return '?';
+ const words = raw.split(/\s+/).filter(Boolean);
+ if (words.length === 1) return words[0].slice(0, 2).toUpperCase();
+ return `${words[0][0] || ''}${words[1][0] || ''}`.toUpperCase();
+}
+
+function resolveAgentHero(agent) {
+ const shareHero = agent?.media?.shareHero?.imageUrl;
+ const avatar = agent?.media?.agentAvatar?.imageUrl;
+ const rawImage = typeof agent?.imageUrl === 'string' ? agent.imageUrl : null;
+ return shareHero || avatar || rawImage || null;
+}
+
+function resolveAgentMediaSource(agent) {
+ return agent?.media?.shareHero?.source || agent?.media?.agentAvatar?.source || null;
+}
+
+function mediaSourceLabel(source) {
+ const key = String(source || '').trim().toLowerCase();
+ if (!key) return 'source unknown';
+ if (key === 'generated') return 'generated hero';
+ if (key === 'erc8004') return '8004scan import';
+ if (key === 'uploaded') return 'owner uploaded';
+ if (key === 'legacy-public-media') return 'legacy media';
+ return key;
+}
+
+function mediaSourceTone(source) {
+ const key = String(source || '').trim().toLowerCase();
+ if (key === 'generated' || key === 'uploaded') return 'good';
+ if (key === 'erc8004' || key === 'legacy-public-media') return 'accent';
+ return 'muted';
+}
+
+function districtNetworkSplit(district) {
+ const mainnet = Number(district?.mainnet?.agents || 0);
+ const testnet = Number(district?.testnets?.agents || 0);
+ const total = Math.max(1, Number(district?.totalAgents || 0));
+ return {
+ mainnet,
+ testnet,
+ mainnetPct: Math.max(0, Math.min(100, Math.round((mainnet / total) * 100))),
+ testnetPct: Math.max(0, Math.min(100, Math.round((testnet / total) * 100)))
+ };
+}
+
+function updateAtlasKpis(districts, opts = {}) {
+ const query = opts.query || '';
+ const family = opts.family || '';
+ const filtered = (districts || []).filter((d) => districtMatchesFilter(d, query, family));
+
+ const districtCount = el('atlasDistrictCount');
+ if (districtCount) districtCount.textContent = formatNumber(filtered.length);
+
+ const visibleAgents = el('atlasVisibleAgents');
+ if (visibleAgents) {
+ const total = filtered.reduce((sum, d) => sum + Number(d?.agentCount || 0), 0);
+ visibleAgents.textContent = formatNumber(total);
+ }
+}
+
+function setAgentVisual(img, fallback, url, label) {
+ const text = String(label || '?').slice(0, 2).toUpperCase();
+ if (!img || !fallback) return;
+
+ fallback.textContent = text;
+ if (!url) {
+ img.removeAttribute('src');
+ img.classList.add('is-hidden');
+ fallback.classList.remove('is-hidden');
+ return;
+ }
+
+ img.classList.remove('is-hidden');
+ fallback.classList.add('is-hidden');
+ img.src = url;
+ img.onerror = () => {
+ img.classList.add('is-hidden');
+ fallback.classList.remove('is-hidden');
+ };
+}
+
+function shortAddress(value, start = 6, end = 4) {
+ const raw = String(value || '').trim();
+ if (!raw) return '';
+ if (raw.length <= start + end + 2) return raw;
+ return `${raw.slice(0, start)}...${raw.slice(-end)}`;
+}
+
+function makeChip(text, tone = 'muted') {
+ const chip = document.createElement('span');
+ chip.className = 'atlas-chip';
+ if (tone === 'good') chip.classList.add('is-good');
+ else if (tone === 'accent') chip.classList.add('is-accent');
+ else chip.classList.add('is-muted');
+ chip.textContent = text;
+ return chip;
+}
+
+function classifyChainType(agent, district) {
+ const chainId = Number(agent?.chainId);
+ if (!district || !Number.isFinite(chainId)) return 'unknown';
+
+ const mainnetChains = Array.isArray(district?.mainnet?.chains) ? district.mainnet.chains : [];
+ const testnetChains = Array.isArray(district?.testnets?.chains) ? district.testnets.chains : [];
+
+ if (mainnetChains.some((row) => Number(row?.chainId) === chainId)) return 'mainnet';
+ if (testnetChains.some((row) => Number(row?.chainId) === chainId)) return 'testnet';
+ return 'unknown';
+}
+
+function hashText(value) {
+ const str = String(value || '');
+ let h = 2166136261;
+ for (let i = 0; i < str.length; i += 1) {
+ h ^= str.charCodeAt(i);
+ h += (h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24);
+ }
+ return h >>> 0;
+}
+
+const DISTRICT_STYLE_BASE_BY_KEY = Object.freeze({
+ ethereum: 'Ethereum',
+ monad: 'Monad',
+ base: 'Base',
+ gnosis: 'gnosis',
+ bsc: 'bsc',
+ arbitrum: 'Arbitrum',
+ optimism: 'Optimism',
+ polygon: 'Polygon',
+ celo: 'Celo',
+ avalanche: 'Avalanche',
+ scroll: 'Scroll',
+ linea: 'linea',
+ mantle: 'Mantle',
+ metis: 'Metis',
+ taiko: 'Taiko',
+ abstract: 'Abstract',
+ megaeth: 'MegaETH',
+ 'x-layer': 'XLayer',
+ solana: 'Solana'
+});
+
+const DISTRICT_LOGO_FILE_BY_KEY = Object.freeze({
+ ethereum: 'Ethereum.png',
+ monad: 'Monad.ico',
+ base: 'Base.png',
+ gnosis: 'Gnosis.png',
+ bsc: 'BSC.png',
+ arbitrum: 'Arbitrum.png',
+ optimism: 'Optimism.png',
+ polygon: 'Polygon.png',
+ celo: 'Celo.png',
+ avalanche: 'Avalanche.png',
+ scroll: 'Scroll.png',
+ linea: 'Linea.png',
+ mantle: 'Mantle.png',
+ metis: 'Metis.png',
+ taiko: 'Taiko.png',
+ abstract: 'Abstract.jpg',
+ megaeth: 'MegaETH.jpeg',
+ 'x-layer': 'X-layer.png',
+ solana: 'Solana.jpeg'
+});
+
+function districtStyleImagePath(district) {
+ const key = String(district?.key || '').trim().toLowerCase();
+ const base = DISTRICT_STYLE_BASE_BY_KEY[key];
+ if (!base) return null;
+ const variant = (hashText(`${key}|${district?.totalAgents || 0}`) % 2) + 1;
+ const file = `${base}_${variant}.png`;
+ return `url("/images/districts_style_images/${file}")`;
+}
+
+function districtLogoPath(district) {
+ const key = String(district?.key || '').trim().toLowerCase();
+ const file = DISTRICT_LOGO_FILE_BY_KEY[key];
+ if (!file) return null;
+ return `/images/districts_style_images/logos/${file}`;
+}
+
+function computeDistrictBaseSpan(totalAgents, minAgents, maxAgents) {
+ const min = Math.max(0, Number(minAgents) || 0);
+ const max = Math.max(min + 1, Number(maxAgents) || 1);
+ const value = Math.max(min, Number(totalAgents) || 0);
+ const minLog = Math.log1p(min);
+ const maxLog = Math.log1p(max);
+ const valueLog = Math.log1p(value);
+ const ratio = (valueLog - minLog) / Math.max(1e-9, maxLog - minLog);
+ const eased = Math.pow(Math.max(0, Math.min(1, ratio)), 0.68);
+
+ // Use equal spans for a square-like treemap tile system.
+ return 5 + Math.round(eased * 4); // 5..9
+}
+
+function computeDistrictTileSpan(totalAgents, minAgents, maxAgents, sizeScale = 1) {
+ const sideBase = computeDistrictBaseSpan(totalAgents, minAgents, maxAgents);
+ const sideSpan = Math.round(sideBase * Math.max(0.6, Number(sizeScale) || 1));
+ const side = Math.max(4, Math.min(12, sideSpan));
+
+ return {
+ colSpan: side,
+ rowSpan: side
+ };
+}
+
+function isMobileAtlasListLayout() {
+ if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return false;
+ return window.matchMedia('(max-width: 860px)').matches;
+}
+
+function readAtlasGridMetrics(stage) {
+ if (!stage || typeof window === 'undefined' || typeof window.getComputedStyle !== 'function') return null;
+ const styles = window.getComputedStyle(stage);
+
+ let cols = Number(styles.getPropertyValue('--atlas-cols'));
+ if (!Number.isFinite(cols) || cols <= 0) {
+ const template = String(styles.gridTemplateColumns || '').trim();
+ cols = template ? template.split(/\s+/).length : 0;
+ }
+ if (!Number.isFinite(cols) || cols <= 0) cols = 24;
+
+ const rowHeight = parseFloat(String(styles.gridAutoRows || '')) || 16;
+ const gap = parseFloat(String(styles.rowGap || styles.gap || '')) || 0;
+ const visibleRows = Math.max(1, Math.floor((stage.clientHeight + gap) / Math.max(1, rowHeight + gap)));
+ return {
+ cols,
+ rowHeight,
+ gap,
+ visibleRows,
+ totalCells: cols * visibleRows
+ };
+}
+
+function setModalOpen(open) {
+ const backdrop = el('atlasModalBackdrop');
+ if (!backdrop) return;
+ backdrop.classList.toggle('is-hidden', !open);
+ backdrop.setAttribute('aria-hidden', open ? 'false' : 'true');
+ document.body.classList.toggle('atlas-modal-open', open);
+}
+
+function closeAtlasModal() {
+ const detail = el('atlasDistrictDetail');
+ const storefront = el('storefrontDrawer');
+ if (detail) detail.classList.add('is-hidden');
+ if (storefront) storefront.classList.add('is-hidden');
+ setModalOpen(false);
+ state.storefrontAgentId = null;
+ state.selectedDistrictKey = null;
+ renderDistricts(state.districts, { query: state.currentQuery, family: state.currentFamily });
+ setUrlState({ district: null, agent: null });
+}
+
+function closeStorefront() {
+ const drawer = el('storefrontDrawer');
+ if (drawer) drawer.classList.add('is-hidden');
+ state.storefrontAgentId = null;
+
+ const params = new URLSearchParams(window.location.search);
+ const district = params.get('district');
+ setUrlState({ district, agent: null });
+
+ const detail = el('atlasDistrictDetail');
+ if (detail && detail.classList.contains('is-hidden')) {
+ setModalOpen(false);
+ }
+}
+
+function resetStorefrontOptOutUi() {
+ const confirmBtn = el('storefrontOptOutConfirmBtn');
+ const status = el('storefrontOptOutStatus');
+ if (confirmBtn) confirmBtn.classList.add('is-hidden');
+ if (status) {
+ status.style.color = 'var(--muted)';
+ status.textContent = '';
+ }
+}
+
+function initStorefrontOptOutControls() {
+ const openBtn = el('storefrontOptOutBtn');
+ const confirmBtn = el('storefrontOptOutConfirmBtn');
+ const status = el('storefrontOptOutStatus');
+ if (!openBtn || !confirmBtn || !status) return;
+
+ openBtn.addEventListener('click', () => {
+ confirmBtn.classList.remove('is-hidden');
+ status.style.color = 'var(--bad)';
+ status.textContent = 'This requires wallet ownership proof and will remove the storefront.';
+ });
+
+ confirmBtn.addEventListener('click', () => {
+ const id = state.storefrontAgentId || 'unknown';
+ status.style.color = 'var(--muted)';
+ status.textContent = `To finalize delete for ${id}, call /api/erc8004/optout with owner signature.`;
+ });
+}
+
+function extractCapabilityTags(agent) {
+ const text = `${agent?.name || ''} ${agent?.description || ''}`.toLowerCase();
+ const tags = [];
+ if (text.includes('monitor') || text.includes('sentinel') || text.includes('watch')) tags.push('monitoring');
+ if (text.includes('route') || text.includes('dispatch') || text.includes('courier')) tags.push('routing');
+ if (text.includes('coord') || text.includes('orchestr') || text.includes('ops')) tags.push('orchestration');
+ if (text.includes('archive') || text.includes('index') || text.includes('search')) tags.push('knowledge');
+ if (text.includes('trade') || text.includes('market') || text.includes('price')) tags.push('market');
+ return tags.slice(0, 3);
+}
+
+function renderStorefront(agent) {
+ const drawer = el('storefrontDrawer');
+ const idEl = el('storefrontAgentId');
+ const nameEl = el('storefrontAgentName');
+ const descEl = el('storefrontAgentDesc');
+ const metaEl = el('storefrontMeta');
+ const chipsEl = el('storefrontChips');
+ const shareLink = el('storefrontShareLink');
+ const atlasLink = el('storefrontAtlasLink');
+ const hero = el('storefrontHeroImage');
+ const heroFallback = el('storefrontHeroFallback');
+
+ if (!drawer || !idEl || !nameEl || !descEl || !shareLink || !atlasLink) return;
+
+ const id = String(agent?.erc8004Id || '').trim();
+ if (!id) return;
+
+ const district = state.districtMap.get(agent?.districtKey) || null;
+ const districtLabel = district?.label || String(agent?.districtKey || 'Unknown district');
+ const chainText = Number.isFinite(Number(agent?.chainId)) ? `chain ${agent.chainId}` : 'chain n/a';
+ const chainType = classifyChainType(agent, district);
+ const owner = shortAddress(agent?.ownerAddress || '');
+
+ state.storefrontAgentId = id;
+ idEl.textContent = id;
+ nameEl.textContent = agent?.name || `Agent ${id}`;
+ descEl.textContent = agent?.description || 'No description provided from source metadata.';
+ if (metaEl) metaEl.textContent = `${districtLabel} • ${chainText}${owner ? ` • owner ${owner}` : ''}`;
+
+ const deepLinkParams = new URLSearchParams();
+ if (agent?.districtKey) deepLinkParams.set('district', agent.districtKey);
+ deepLinkParams.set('agent', id);
+
+ shareLink.href = agent?.sharePath || `/atlas?${deepLinkParams.toString()}`;
+ atlasLink.href = `/atlas?${deepLinkParams.toString()}`;
+
+ if (chipsEl) {
+ chipsEl.innerHTML = '';
+ chipsEl.appendChild(makeChip(chainType === 'unknown' ? 'network unknown' : chainType, chainType === 'mainnet' ? 'good' : 'accent'));
+ chipsEl.appendChild(makeChip(mediaSourceLabel(resolveAgentMediaSource(agent)), mediaSourceTone(resolveAgentMediaSource(agent))));
+ const caps = extractCapabilityTags(agent);
+ for (const cap of caps) chipsEl.appendChild(makeChip(cap, 'muted'));
+ if (agent?.media?.shareHero?.imageUrl) chipsEl.appendChild(makeChip('share hero', 'good'));
+ if (agent?.media?.agentAvatar?.imageUrl) chipsEl.appendChild(makeChip('agent avatar', 'accent'));
+ }
+
+ setAgentVisual(hero, heroFallback, resolveAgentHero(agent), initialsFromAgent(agent));
+ drawer.classList.remove('is-hidden');
+ setModalOpen(true);
+ resetStorefrontOptOutUi();
+}
+
+function renderSearchResults(payload) {
+ const list = el('atlasSearchResults');
+ const meta = el('atlasSearchMeta');
+ if (!list || !meta) return;
+
+ const results = Array.isArray(payload?.results) ? payload.results : [];
+ const q = payload?.query?.q || '';
+ const family = payload?.query?.family || '';
+ const searchType = normalizeSearchType(payload?.query?.searchType || 'keyword');
+ const sortField = normalizeSortField(payload?.query?.sortField || 'relevance');
+ const sortDirection = normalizeSortDirection(payload?.query?.sortDirection || 'desc');
+ const total = Number(payload?.query?.total || 0);
+ const shown = results.length;
+ const filterParts = [];
+ if (family) filterParts.push(`family: ${family}`);
+ if (payload?.query?.hasWeb === true) filterParts.push('has web');
+ if (payload?.query?.hasMcp === true) filterParts.push('has MCP');
+ if (payload?.query?.hasA2a === true) filterParts.push('has A2A');
+ if (payload?.query?.active === true) filterParts.push('active only');
+ const filterNote = filterParts.length ? ` • ${filterParts.join(' • ')}` : '';
+ const queryNote = q ? `query: "${q}"` : 'query: all storefronts';
+ meta.textContent = `${queryNote}${filterNote} • ${searchType}/${sortField}/${sortDirection} • showing ${shown} of ${total}`;
+
+ list.innerHTML = '';
+ if (!results.length) {
+ const empty = document.createElement('div');
+ empty.className = 'small atlas-empty';
+ empty.textContent = 'No agents match this search.';
+ list.appendChild(empty);
+ return;
+ }
+
+ for (const row of results) {
+ upsertAgents([row]);
+
+ const card = document.createElement('article');
+ card.className = 'card atlas-market-card';
+ card.setAttribute('data-testid', `atlas-search-result-${row.erc8004Id}`);
+
+ const heroWrap = document.createElement('div');
+ heroWrap.className = 'atlas-market-hero';
+ const hero = document.createElement('img');
+ hero.alt = `${row.name || row.erc8004Id} hero`;
+ hero.loading = 'lazy';
+ const fallback = document.createElement('div');
+ fallback.className = 'atlas-agent-fallback';
+ setAgentVisual(hero, fallback, resolveAgentHero(row), initialsFromAgent(row));
+ heroWrap.appendChild(hero);
+ heroWrap.appendChild(fallback);
+
+ const body = document.createElement('div');
+ body.className = 'atlas-market-body';
+
+ const title = document.createElement('div');
+ title.className = 'atlas-market-title';
+ title.textContent = row.name || row.erc8004Id;
+
+ const idLine = document.createElement('div');
+ idLine.className = 'small';
+ const chainLabel = row.chainName ? `${row.chainName} (${row.chainId})` : `chain ${row.chainId}`;
+ const networkLabel = row.networkType || 'network unknown';
+ idLine.textContent = `${row.erc8004Id} • ${chainLabel} • ${networkLabel} • ${row.districtLabel || row.districtKey}`;
+
+ const desc = document.createElement('div');
+ desc.className = 'small atlas-market-desc';
+ desc.textContent = row.description || 'No storefront description available.';
+
+ const chipRow = document.createElement('div');
+ chipRow.className = 'atlas-chip-row';
+ chipRow.appendChild(makeChip('quick view modal', 'accent'));
+ if (row.networkType) chipRow.appendChild(makeChip(row.networkType, row.networkType === 'mainnet' ? 'good' : 'accent'));
+ chipRow.appendChild(makeChip(mediaSourceLabel(resolveAgentMediaSource(row)), mediaSourceTone(resolveAgentMediaSource(row))));
+ if (row.updatedAt) chipRow.appendChild(makeChip('recently indexed', 'muted'));
+
+ const actions = document.createElement('div');
+ actions.className = 'kv atlas-market-actions';
+
+ const openBtn = document.createElement('button');
+ openBtn.className = 'btn';
+ openBtn.type = 'button';
+ openBtn.textContent = 'Open storefront';
+ openBtn.setAttribute('data-testid', `atlas-search-open-${row.erc8004Id}`);
+ openBtn.addEventListener('click', () => {
+ openAgentStorefront(row.erc8004Id).catch((err) => {
+ setAtlasError(mapAgentError(err));
+ });
+ });
+ actions.appendChild(openBtn);
+
+ if (row.sharePath) {
+ const shareLink = document.createElement('a');
+ shareLink.className = 'btn';
+ shareLink.href = row.sharePath;
+ shareLink.textContent = 'Share';
+ shareLink.target = '_blank';
+ shareLink.rel = 'noreferrer';
+ actions.appendChild(shareLink);
+ }
+
+ body.appendChild(title);
+ body.appendChild(idLine);
+ body.appendChild(desc);
+ body.appendChild(chipRow);
+ body.appendChild(actions);
+
+ card.appendChild(heroWrap);
+ card.appendChild(body);
+ list.appendChild(card);
+ }
+}
+
+async function runSearch(query, family, opts = {}) {
+ const seq = ++state.searchRequestSeq;
+ const params = new URLSearchParams();
+ const q = String(query || '').trim();
+ const f = String(family || '').trim();
+ const searchType = normalizeSearchType(opts.searchType);
+ const sortField = normalizeSortField(opts.sortField);
+ const sortDirection = normalizeSortDirection(opts.sortDirection);
+ const hasWeb = opts.hasWeb === true ? true : opts.hasWeb === false ? false : null;
+ const hasMcp = opts.hasMcp === true ? true : opts.hasMcp === false ? false : null;
+ const hasA2a = opts.hasA2a === true ? true : opts.hasA2a === false ? false : null;
+ const active = opts.active === true ? true : opts.active === false ? false : null;
+ if (q) params.set('q', q);
+ if (f) params.set('family', f);
+ if (searchType !== 'keyword') params.set('searchType', searchType);
+ if (sortField !== 'relevance') params.set('sortField', sortField);
+ if (sortDirection !== 'desc') params.set('sortDirection', sortDirection);
+ if (hasWeb !== null) params.set('hasWeb', hasWeb ? '1' : '0');
+ if (hasMcp !== null) params.set('hasMcp', hasMcp ? '1' : '0');
+ if (hasA2a !== null) params.set('hasA2a', hasA2a ? '1' : '0');
+ if (active !== null) params.set('active', active ? '1' : '0');
+ const searchPath = params.toString() ? `/api/atlas/search?${params.toString()}` : '/api/atlas/search';
+ const payload = await api(searchPath);
+ if (seq !== state.searchRequestSeq) return;
+ renderSearchResults(payload);
+}
+
+function buildMapRoutes(stage, points) {
+ const svgNs = 'http://www.w3.org/2000/svg';
+ const svg = document.createElementNS(svgNs, 'svg');
+ svg.setAttribute('class', 'atlas-map-routes');
+ svg.setAttribute('viewBox', '0 0 100 100');
+ svg.setAttribute('preserveAspectRatio', 'none');
+
+ const ordered = points.slice().sort((a, b) => b.weight - a.weight);
+ for (let i = 1; i < ordered.length; i += 1) {
+ const prev = ordered[i - 1];
+ const next = ordered[i];
+ const line = document.createElementNS(svgNs, 'line');
+ line.setAttribute('x1', String(prev.x));
+ line.setAttribute('y1', String(prev.y));
+ line.setAttribute('x2', String(next.x));
+ line.setAttribute('y2', String(next.y));
+ line.setAttribute('class', 'atlas-route-line');
+ svg.appendChild(line);
+ }
+
+ stage.appendChild(svg);
+}
+
+function renderDistricts(districts, { query = '', family = '' } = {}) {
+ const list = el('atlasDistrictList');
+ if (!list) return;
+
+ updateAtlasKpis(districts, { query, family });
+ list.innerHTML = '';
+ list.classList.add('atlas-tile-map');
+
+ const filtered = districts
+ .filter((d) => districtMatchesFilter(d, query, family))
+ .slice()
+ .sort((a, b) => Number(b?.totalAgents || 0) - Number(a?.totalAgents || 0) || String(a?.label || '').localeCompare(String(b?.label || '')));
+ if (!filtered.length) {
+ const empty = document.createElement('div');
+ empty.className = 'small atlas-empty';
+ empty.textContent = 'No districts match this filter.';
+ list.appendChild(empty);
+ return;
+ }
+
+ const allAgents = filtered.map((d) => Number(d?.totalAgents || 0));
+ const minAgents = allAgents.reduce((acc, n) => Math.min(acc, n), Number.POSITIVE_INFINITY);
+ const maxAgents = allAgents.reduce((acc, n) => Math.max(acc, n), 0);
+ const mobileListLayout = isMobileAtlasListLayout();
+
+ let tileScale = 1;
+ if (!mobileListLayout) {
+ const metrics = readAtlasGridMetrics(list);
+ if (metrics && metrics.totalCells > 0) {
+ const baseArea = filtered.reduce((sum, district) => {
+ const side = computeDistrictBaseSpan(district.totalAgents, minAgents, maxAgents);
+ return sum + side * side;
+ }, 0);
+ if (baseArea > 0) {
+ const fillTarget = filtered.length <= 6 ? 0.98 : filtered.length <= 10 ? 0.95 : 0.93;
+ tileScale = Math.sqrt((metrics.totalCells * fillTarget) / baseArea);
+ tileScale = Math.max(0.75, Math.min(2.6, tileScale));
+ }
+ }
+ }
+
+ filtered.forEach((district) => {
+ const card = document.createElement('article');
+ card.className = 'card atlas-map-node';
+ if (district.key === state.selectedDistrictKey) card.classList.add('is-selected');
+ card.dataset.testid = `district-card-${district.key}`;
+ card.setAttribute('data-testid', `district-card-${district.key}`);
+
+ const tile = computeDistrictTileSpan(district.totalAgents, minAgents, maxAgents, tileScale);
+ card.style.setProperty('--tile-col-span', String(tile.colSpan));
+ card.style.setProperty('--tile-row-span', String(tile.rowSpan));
+ const bgImage = districtStyleImagePath(district);
+ if (bgImage) card.style.setProperty('--district-style-image', bgImage);
+ else card.style.removeProperty('--district-style-image');
+ if (tile.colSpan <= 6) card.classList.add('is-compact');
+ if (tile.colSpan >= 8) card.classList.add('is-large');
+
+ const split = districtNetworkSplit(district);
+
+ const head = document.createElement('div');
+ head.className = 'atlas-district-head';
+
+ const titleRow = document.createElement('div');
+ titleRow.className = 'atlas-district-title-row';
+
+ const title = document.createElement('h3');
+ title.textContent = district.label;
+
+ const logoPath = districtLogoPath(district);
+ if (logoPath) {
+ const logo = document.createElement('img');
+ logo.className = 'atlas-district-logo';
+ logo.src = logoPath;
+ logo.alt = '';
+ logo.loading = 'lazy';
+ logo.decoding = 'async';
+ logo.referrerPolicy = 'no-referrer';
+ logo.addEventListener('error', () => {
+ logo.remove();
+ });
+ titleRow.appendChild(logo);
+ }
+ titleRow.appendChild(title);
+
+ const stats = document.createElement('div');
+ stats.className = 'small';
+ stats.textContent = `${formatNumber(district.totalAgents)} agents`;
+
+ head.appendChild(titleRow);
+ head.appendChild(stats);
+
+ const ctaRow = document.createElement('div');
+ ctaRow.className = 'kv atlas-district-actions';
+
+ const openBtn = document.createElement('button');
+ openBtn.className = 'btn';
+ openBtn.type = 'button';
+ openBtn.textContent = 'Open district';
+ openBtn.setAttribute('data-testid', `district-open-${district.key}`);
+ openBtn.addEventListener('click', () => {
+ openDistrictDetail(district.key).catch((err) => {
+ setAtlasError(mapAgentError(err));
+ });
+ });
+ ctaRow.appendChild(openBtn);
+
+ const splitMeta = document.createElement('div');
+ splitMeta.className = 'small atlas-district-split-chip';
+ splitMeta.textContent = `${split.mainnetPct}% main • ${split.testnetPct}% test`;
+
+ const splitBar = document.createElement('div');
+ splitBar.className = 'atlas-district-split-bar';
+ const splitMain = document.createElement('span');
+ splitMain.className = 'is-main';
+ splitMain.style.width = `${Math.max(8, split.mainnetPct)}%`;
+ const splitTest = document.createElement('span');
+ splitTest.className = 'is-test';
+ splitTest.style.width = `${Math.max(8, split.testnetPct)}%`;
+ splitBar.appendChild(splitMain);
+ splitBar.appendChild(splitTest);
+
+ const splitWrap = document.createElement('div');
+ splitWrap.className = 'atlas-district-split-wrap';
+ splitWrap.appendChild(splitBar);
+ splitWrap.appendChild(splitMeta);
+ ctaRow.appendChild(splitWrap);
+
+ card.appendChild(head);
+ card.appendChild(ctaRow);
+ list.appendChild(card);
+ });
+}
+
+async function openDistrictDetail(key, opts = {}) {
+ if (!key) return;
+
+ const detailPanel = el('atlasDistrictDetail');
+ const title = el('atlasDistrictTitle');
+ const stats = el('atlasDistrictStats');
+ const agentsWrap = el('atlasDistrictAgents');
+ if (!detailPanel || !title || !stats || !agentsWrap) return;
+
+ let payload = state.districtDetailCache.get(key);
+ if (!payload) {
+ try {
+ payload = await api(`/api/atlas/district/${encodeURIComponent(key)}`);
+ } catch (err) {
+ if (String(err?.message || '') === 'NOT_FOUND') {
+ throw new Error('DISTRICT_NOT_FOUND');
+ }
+ throw err;
+ }
+ state.districtDetailCache.set(key, payload);
+ }
+
+ const district = payload?.district || null;
+ const agents = Array.isArray(payload?.agents) ? payload.agents : [];
+ if (!district) throw new Error('DISTRICT_NOT_FOUND');
+
+ state.selectedDistrictKey = district.key;
+ upsertAgents(agents);
+ renderDistricts(state.districts, { query: state.currentQuery, family: state.currentFamily });
+
+ title.textContent = `${district.label || district.key} District`;
+ stats.textContent = `${formatNumber(district.totalAgents)} total • ${formatNumber(district.mainnet?.agents || 0)} mainnet • ${formatNumber(district.testnets?.agents || 0)} testnet • ${formatNumber(agents.length)} storefront profiles`;
+
+ agentsWrap.innerHTML = '';
+ if (!agents.length) {
+ const empty = document.createElement('div');
+ empty.className = 'small atlas-empty';
+ empty.textContent = 'No storefront agents listed yet.';
+ agentsWrap.appendChild(empty);
+ } else {
+ for (const agent of agents) {
+ const id = String(agent?.erc8004Id || '').trim();
+ if (!id) continue;
+
+ const btn = document.createElement('button');
+ btn.className = 'atlas-agent-tile';
+ btn.type = 'button';
+ btn.setAttribute('data-testid', `agent-open-${id}`);
+
+ const media = document.createElement('div');
+ media.className = 'atlas-agent-media';
+ const img = document.createElement('img');
+ img.alt = `${agent.name || id} avatar`;
+ img.loading = 'lazy';
+ const fb = document.createElement('div');
+ fb.className = 'atlas-agent-fallback';
+ setAgentVisual(img, fb, resolveAgentHero(agent), initialsFromAgent(agent));
+ media.appendChild(img);
+ media.appendChild(fb);
+
+ const content = document.createElement('div');
+ content.className = 'atlas-agent-copy';
+
+ const name = document.createElement('div');
+ name.className = 'atlas-agent-name';
+ name.textContent = agent.name || id;
+
+ const meta = document.createElement('div');
+ meta.className = 'small';
+ const network = classifyChainType(agent, district);
+ const networkLabel = network === 'unknown' ? 'network unknown' : network;
+ meta.textContent = `${id} • ${networkLabel}`;
+
+ const desc = document.createElement('div');
+ desc.className = 'small atlas-agent-desc';
+ desc.textContent = agent.description || 'No description available.';
+
+ const chips = document.createElement('div');
+ chips.className = 'atlas-chip-row';
+ const capTags = extractCapabilityTags(agent);
+ for (const tag of capTags) chips.appendChild(makeChip(tag, 'muted'));
+
+ content.appendChild(name);
+ content.appendChild(meta);
+ content.appendChild(desc);
+ if (capTags.length) content.appendChild(chips);
+
+ btn.appendChild(media);
+ btn.appendChild(content);
+
+ btn.addEventListener('click', () => {
+ renderStorefront(agent);
+ setUrlState({ district: district.key, agent: id });
+ });
+
+ agentsWrap.appendChild(btn);
+ }
+ }
+
+ detailPanel.classList.remove('is-hidden');
+ setModalOpen(true);
+ if (!opts.silent) {
+ setUrlState({ district: district.key, agent: opts.agent || null });
+ }
+}
+
+async function openAgentStorefront(erc8004Id) {
+ const id = String(erc8004Id || '').trim();
+ if (!id) return;
+
+ let agent = state.agentsById.get(id) || null;
+ if (!agent) {
+ const payload = await api(`/api/atlas/agent/${encodeURIComponent(id)}`);
+ agent = payload?.agent || null;
+ if (!agent) throw new Error('NOT_FOUND');
+ state.agentsById.set(id, agent);
+ }
+
+ if (agent.districtKey) {
+ await openDistrictDetail(agent.districtKey, { silent: true, agent: id });
+ agent = state.agentsById.get(id) || agent;
+ }
+
+ renderStorefront(agent);
+ setUrlState({ district: agent.districtKey || null, agent: id });
+}
+
+function initFilters(districts) {
+ const search = el('atlasSearch');
+ const familySelect = el('atlasChainFamily');
+ const searchTypeSelect = el('atlasSearchType');
+ const sortFieldSelect = el('atlasSortField');
+ const sortDirectionSelect = el('atlasSortDirection');
+ const hasWebInput = el('atlasFilterHasWeb');
+ const hasMcpInput = el('atlasFilterHasMcp');
+ const hasA2aInput = el('atlasFilterHasA2a');
+ const activeInput = el('atlasFilterActive');
+ const foldout = el('atlasSearchFoldout');
+ const foldoutBody = el('atlasSearchFoldoutBody');
+ const toggleBtn = el('atlasSearchToggle');
+ const summaryEl = el('atlasSearchToggleSummary');
+ if (
+ !search
+ || !familySelect
+ || !searchTypeSelect
+ || !sortFieldSelect
+ || !sortDirectionSelect
+ || !hasWebInput
+ || !hasMcpInput
+ || !hasA2aInput
+ || !activeInput
+ || !foldout
+ || !foldoutBody
+ || !toggleBtn
+ || !summaryEl
+ ) return;
+
+ for (const district of districts) {
+ const option = document.createElement('option');
+ option.value = district.key;
+ option.textContent = district.label;
+ familySelect.appendChild(option);
+ }
+
+ function collectSearchOpts() {
+ return {
+ searchType: normalizeSearchType(searchTypeSelect.value),
+ sortField: normalizeSortField(sortFieldSelect.value),
+ sortDirection: normalizeSortDirection(sortDirectionSelect.value),
+ hasWeb: hasWebInput.checked ? true : null,
+ hasMcp: hasMcpInput.checked ? true : null,
+ hasA2a: hasA2aInput.checked ? true : null,
+ active: activeInput.checked ? true : null
+ };
+ }
+
+ function countActiveSignals(opts) {
+ let count = 0;
+ if (opts.hasWeb === true) count += 1;
+ if (opts.hasMcp === true) count += 1;
+ if (opts.hasA2a === true) count += 1;
+ if (opts.active === true) count += 1;
+ if (opts.searchType !== 'keyword') count += 1;
+ if (opts.sortField !== 'relevance') count += 1;
+ if (opts.sortDirection !== 'desc') count += 1;
+ return count;
+ }
+
+ function setFoldoutOpen(open) {
+ const isOpen = open === true;
+ foldout.classList.toggle('is-collapsed', !isOpen);
+ foldoutBody.classList.toggle('is-hidden', !isOpen);
+ toggleBtn.setAttribute('aria-expanded', isOpen ? 'true' : 'false');
+ }
+
+ function updateSummary(query, family, opts) {
+ const activeSignals = countActiveSignals(opts);
+ const parts = [];
+ if (query) parts.push(`q: ${query.length > 16 ? `${query.slice(0, 16)}…` : query}`);
+ if (family) parts.push(family);
+ if (activeSignals > 0) parts.push(`${activeSignals} advanced`);
+ summaryEl.textContent = parts.length ? parts.join(' • ') : 'all storefronts';
+ }
+
+ const urlParams = new URLSearchParams(window.location.search);
+ const initialQuery = urlParams.get('q');
+ const initialFamily = urlParams.get('family') || urlParams.get('chainFamily');
+ const initialSearchType = normalizeSearchType(urlParams.get('searchType'));
+ const initialSortField = normalizeSortField(urlParams.get('sortField'));
+ const initialSortDirection = normalizeSortDirection(urlParams.get('sortDirection'));
+ const initialHasWeb = parseBoolQueryParam(urlParams.get('hasWeb'));
+ const initialHasMcp = parseBoolQueryParam(urlParams.get('hasMcp'));
+ const initialHasA2a = parseBoolQueryParam(urlParams.get('hasA2a'));
+ const initialActive = parseBoolQueryParam(urlParams.get('active'));
+
+ if (initialQuery) search.value = initialQuery;
+ if (initialFamily) familySelect.value = initialFamily;
+ searchTypeSelect.value = initialSearchType;
+ sortFieldSelect.value = initialSortField;
+ sortDirectionSelect.value = initialSortDirection;
+ hasWebInput.checked = initialHasWeb === true;
+ hasMcpInput.checked = initialHasMcp === true;
+ hasA2aInput.checked = initialHasA2a === true;
+ activeInput.checked = initialActive === true;
+
+ const hasInitialParams = !!(
+ initialQuery
+ || initialFamily
+ || initialSearchType !== 'keyword'
+ || initialSortField !== 'relevance'
+ || initialSortDirection !== 'desc'
+ || initialHasWeb === true
+ || initialHasMcp === true
+ || initialHasA2a === true
+ || initialActive === true
+ );
+ setFoldoutOpen(hasInitialParams);
+
+ if (toggleBtn.dataset.bound !== '1') {
+ toggleBtn.dataset.bound = '1';
+ toggleBtn.addEventListener('click', () => {
+ setFoldoutOpen(foldout.classList.contains('is-collapsed'));
+ });
+ }
+
+ async function rerender() {
+ const query = search.value || '';
+ const family = familySelect.value || '';
+ const opts = collectSearchOpts();
+ state.currentQuery = query;
+ state.currentFamily = family;
+ state.currentSearchOpts = opts;
+ updateSummary(query, family, opts);
+ clearAtlasError();
+ renderDistricts(districts, { query, family });
+ try {
+ await runSearch(query, family, opts);
+ } catch (err) {
+ setAtlasError(mapAgentError(err));
+ }
+ }
+
+ search.addEventListener('input', () => { rerender(); });
+ familySelect.addEventListener('change', () => { rerender(); });
+ searchTypeSelect.addEventListener('change', () => { rerender(); });
+ sortFieldSelect.addEventListener('change', () => { rerender(); });
+ sortDirectionSelect.addEventListener('change', () => { rerender(); });
+ hasWebInput.addEventListener('change', () => { rerender(); });
+ hasMcpInput.addEventListener('change', () => { rerender(); });
+ hasA2aInput.addEventListener('change', () => { rerender(); });
+ activeInput.addEventListener('change', () => { rerender(); });
+ rerender();
+}
+
+function setWorkerDockState(payload) {
+ const dot = el('atlasWorkerDot');
+ const status = el('atlasWorkerStatus');
+ const team = el('atlasWorkerTeam');
+ const name = el('atlasWorkerName');
+ if (!dot || !status || !team || !name) return;
+
+ const connected = payload?.agent?.connected === true;
+ const matched = payload?.match?.matched === true;
+ const openReady = payload?.human?.openPressed && payload?.agent?.openPressed;
+
+ dot.classList.toggle('is-online', connected);
+ dot.classList.toggle('is-busy', connected && !matched);
+
+ if (!connected) status.textContent = 'Worker idle. Connect agent to enable co-op signals.';
+ else if (!matched) status.textContent = 'Worker connected. Waiting for a matched sigil.';
+ else if (!openReady) status.textContent = 'Match locked. Awaiting both open presses.';
+ else status.textContent = 'Worker active. Co-op state synchronized.';
+
+ team.textContent = payload?.teamCode || '—';
+ name.textContent = payload?.agent?.name || 'Unassigned';
+}
+
+async function refreshWorkerDock() {
+ try {
+ const payload = await api('/api/state');
+ setWorkerDockState(payload);
+ } catch {
+ setWorkerDockState(null);
+ }
+}
+
+function initWorkerDock() {
+ refreshWorkerDock();
+ if (state.workerPollTimer) clearInterval(state.workerPollTimer);
+ state.workerPollTimer = setInterval(() => {
+ refreshWorkerDock();
+ }, 15000);
+}
+
+function initModalControls() {
+ const closeBtn = el('atlasModalCloseBtn');
+ if (closeBtn) {
+ closeBtn.addEventListener('click', () => {
+ closeAtlasModal();
+ });
+ }
+
+ const backdrop = el('atlasModalBackdrop');
+ if (backdrop) {
+ backdrop.addEventListener('click', (ev) => {
+ if (ev.target !== backdrop) return;
+ closeAtlasModal();
+ });
+ }
+
+ document.addEventListener('keydown', (ev) => {
+ if (ev.key !== 'Escape') return;
+ const open = backdrop && !backdrop.classList.contains('is-hidden');
+ if (!open) return;
+ closeAtlasModal();
+ });
+}
+
+async function init() {
+ await initHouseNavLink();
+ initWorkerDock();
+
+ const data = await api('/api/atlas/districts');
+ const districts = Array.isArray(data?.districts) ? data.districts : [];
+ state.districts = districts;
+ state.districtMap = new Map(districts.map((d) => [d.key, d]));
+
+ initFilters(districts);
+
+ const closeBtn = el('storefrontCloseBtn');
+ if (closeBtn) closeBtn.addEventListener('click', closeStorefront);
+ initStorefrontOptOutControls();
+ initModalControls();
+
+ const params = new URLSearchParams(window.location.search);
+ const districtParam = params.get('district');
+ const agentParam = params.get('agent');
+
+ if (districtParam) {
+ try {
+ await openDistrictDetail(districtParam, { silent: true });
+ } catch (err) {
+ setAtlasError(mapAgentError(err));
+ }
+ }
+
+ if (agentParam) {
+ try {
+ await openAgentStorefront(agentParam);
+ } catch (err) {
+ setAtlasError(mapAgentError(err));
+ }
+ }
+
+ let resizeTimer = null;
+ window.addEventListener('resize', () => {
+ if (resizeTimer) clearTimeout(resizeTimer);
+ resizeTimer = setTimeout(() => {
+ renderDistricts(state.districts, { query: state.currentQuery, family: state.currentFamily });
+ }, 100);
+ });
+}
+
+init().catch((err) => {
+ setAtlasError(`Error: ${err.message || 'UNKNOWN'}`);
+});
diff --git a/public/create.html b/public/create.html
index 31b0e93..52a0042 100644
--- a/public/create.html
+++ b/public/create.html
@@ -57,10 +57,9 @@ 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Atlas Market Districts
+Map and marketplace for ERC-8004 agents sourced from 8004scan refresh data.
+
+
+
+ Districts
+ 0
+
+
+ Visible agents
+ 0
+
+
+
+
+
+
+
+
+
+
+
+ Agent Worker Dock
+
+
+ Worker status unknown.
+ Team code:
+ —Agent: —
+