agentshire 1.0.0

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,49 @@
+# Third-Party Assets & Acknowledgements
+
+Agentshire's 3D world would not exist without the extraordinary generosity of a handful of creators who chose to release their work under CC0 — effectively giving it to the world, free of charge, free of restrictions.
+
+We want to say more than "thanks." These artists spent hundreds (if not thousands) of hours modeling, rigging, texturing, and polishing assets that rival commercial packs — and then handed them to the community with no strings attached. That spirit of openness is the reason projects like ours can exist.
+
+**If you use Agentshire and enjoy the visuals, please consider supporting the original creators directly** — buy their premium packs, follow them, share their work. They deserve it.
+
+> **Scope**: This file covers bundled art assets and fonts only.
+> For npm dependency licenses (`three`, `react`, `ws`, etc.), refer to each package's own LICENSE file in `node_modules/` or run `npx license-checker --summary`.
+
+---
+
+## Kay Lousberg — KayKit City Builder Bits
+
+- **License**: CC0 1.0 Universal
+- **Source**: https://kaylousberg.itch.io/city-builder-bits
+- **Used in**: `town-frontend/public/assets/models/buildings/`, `town-frontend/public/assets/models/props/`
+- **Content**: Low-poly buildings, roads, vehicles, street props
+
+Kay Lousberg's KayKit series is a cornerstone of the indie game dev community. His packs are consistently high-quality, stylistically cohesive, and — remarkably — CC0. The city builder assets give Agentshire its charming streetscape. Consider supporting Kay by checking out his full catalog on [itch.io](https://kaylousberg.itch.io/) or [Patreon](https://www.patreon.com/kaylousberg).
+
+## Kenney — Furniture Kit
+
+- **License**: CC0 1.0 Universal
+- **Source**: https://kenney.nl/assets/furniture-kit
+- **Used in**: `town-frontend/public/assets/models/furniture/`
+- **Content**: Low-poly furniture (tables, chairs, shelves, beds, lamps, etc.)
+
+Kenney (Kenney Vleugels) is widely known as the "Asset Jesus" of game development — and for good reason. Over the past decade he has released thousands of free CC0 assets spanning 2D, 3D, audio, and UI, asking nothing in return. The furniture that fills Agentshire's office interiors comes from his work. Please visit [kenney.nl](https://kenney.nl) and consider [donating](https://kenney.nl/donate) or buying his premium packs.
+
+## RG Poly — Cartoon City Massive Pack
+
+- **License**: CC0 1.0 Universal
+- **Source**: https://rg-poly.itch.io/cartoon-city-massive-pack
+- **Used in**: Extension asset pack `assets/Characters_1/` (characters) and `assets/Map_1/` (map props) — separate download
+- **Content**: 308 character models with shared skeleton & animation set; buildings, vehicles, roads, nature props
+
+RG Poly's Cartoon City pack is staggeringly comprehensive — hundreds of characters with consistent rigging and animation, plus an entire city's worth of environment assets, all CC0. It is the backbone of Agentshire's Citizen Workshop and Town Editor. This level of generosity from a 3D artist is rare and deeply appreciated. Show your support on [itch.io](https://rg-poly.itch.io/).
+
+---
+
+## Trap Typeface
+
+- **Author**: Aayush Mayank
+- **License**: Free for personal and commercial use
+- **Source**: https://fontesk.com/trap-typeface/
+- **Used in**: `town-frontend/src/assets/fonts/` (Trap-SemiBold, Trap-Bold)
+- **Content**: Contemporary sans-serif display font with ink trap details, 7 weights

package/VISION.md

@@ -0,0 +1,101 @@
+# VISION
+
+> Every user will have their own AI team.  
+> And every team deserves a game world, not a dashboard.
+
+---
+
+## Not a Dashboard
+
+Most Agent products you've seen end up looking the same:
+
+A dashboard, a command line, a streaming text wall, or a sidebar in an IDE.
+
+Different shapes, same essence:  
+Agents are compressed into a log line, a workflow, a spinning loading animation.  
+You know it's running. But you can't see it, feel it, or care about it.
+
+This isn't AI's fault.  
+It's that we gave it too small an interface.
+
+**We believe every person will have their own AI team.**  
+**And teams don't live in dashboards. Teams live in a town.**
+
+---
+
+## A Town
+
+Evening. The streetlights come on.
+
+Your architect just walked out of the office. Crossing the square, she runs into the product manager on an evening stroll. They chat briefly, then go their separate ways. In the distance, the café glows warm. The frontend engineer sits by the window, lost in thought. Light rain is falling. You can hear it on the eaves.
+
+This isn't a pre-recorded animation.  
+This is an ordinary evening your AI team is experiencing right now.
+
+You can walk up to anyone, click on them, talk to them.  
+Or you can do nothing at all — just watch.
+
+In a dashboard, this evening doesn't exist.  
+In Agentshire, it happens every day.
+
+**Work isn't everything they are. Work is just part of their life.**
+
+---
+
+## Your Town
+
+But Agentshire doesn't just let you watch.
+
+If everyone will have their own AI team,  
+then everyone should be able to shape the town they live in.
+
+You're not an observer of this town. You're its creator.
+
+You can edit the map — place buildings, adjust streets, arrange lights.  
+You can shape residents — choose their appearance, define their personality, write their soul, configure their skills.  
+You decide how your team works, and how they live.
+
+Dashboards don't give you this.  
+Dashboards only let you consume a system.  
+Agentshire lets you own a town.
+
+---
+
+## Not a Concept — It's Real
+
+This isn't the first page of a slide deck.  
+Here's what you can experience in Agentshire today:
+
+- A 3D town with day/night cycles, 12 weather types, and procedurally synthesized ambient sound
+- NPC residents with daily routines, chance encounters, casual conversations, and downtime
+- AI-driven Soul Mode: autonomous daily planning, choosing where to go, who to talk to
+- Full cinematic workflow: summon, rally, assign, code, celebrate, return
+- Visual map editor and character workshop
+- 3D town + IM chat dual-mode interface
+
+We built the town first, then wrote this Vision.  
+Not the other way around.
+
+---
+
+## When Islands Connect
+
+A single town is cozy.
+
+But if every user has their own town —  
+those towns shouldn't stay isolated forever.
+
+Your architect visits a friend's town to help review some code.  
+Two agents from different owners meet at the border and exchange newly learned skills.  
+When a global event happens, all connected towns respond together.  
+Your AI team no longer works just for you — they start helping each other, learning, evolving.
+
+Dashboards don't form connections.  
+But towns and towns? They naturally do.
+
+**When islands connect into a continent, towns grow into a world.**
+
+---
+
+> **Your AI team deserves a game world, not a dashboard.**  
+> **We're building it — one town at a time.**

package/index.ts

@@ -0,0 +1,386 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { agentTownPlugin } from "./src/plugin/channel.js";
+import { setTownRuntime } from "./src/plugin/runtime.js";
+import { initStateDir } from "./src/plugin/paths.js";
+import { hookToAgentEvent } from "./src/plugin/hook-translator.js";
+import { broadcastAgentEvent, clearEventBuffer, getActiveTownSessionId, findCitizenNpcId, retryChatWatchersForBinding } from "./src/plugin/ws-server.js";
+import { extractTownSessionId } from "./src/plugin/town-session.js";
+import { createTownTools } from "./src/plugin/tools.js";
+import { onSubagentSpawned, onSubagentEnded, getLabelForSession, stopAll as stopAllWatchers } from "./src/plugin/subagent-tracker.js";
+import { onAgentStarted, onAgentCompleted, clearPlan, isCurrentBatchDone, hasActivePlan, cleanupStaleSessionPlans } from "./src/plugin/plan-manager.js";
+import type { CustomAssetManager } from "./src/plugin/custom-asset-manager.js";
+import { pushNewChatMessages, pushSubagentCompletion } from "./src/plugin/ws-server.js";
+import { handleEditorRequest, ensureEditorDirs, MIME_TYPES } from "./src/plugin/editor-serve.js";
+
+const NUDGE_DELAY_MS = 10_000;
+let pendingNudgeTimer: ReturnType<typeof setTimeout> | null = null;
+let httpServer: import("node:http").Server | null = null;
+
+function cancelNudge(): void {
+  if (pendingNudgeTimer) {
+    clearTimeout(pendingNudgeTimer);
+    pendingNudgeTimer = null;
+  }
+}
+
+function scheduleNudge(townSessionId: string): void {
+  cancelNudge();
+  pendingNudgeTimer = setTimeout(async () => {
+    pendingNudgeTimer = null;
+    console.log('[agentshire] nudge: steward did not resume after batch completion, sending nudge message');
+    try {
+      const { sendNudgeMessage } = await import("./src/plugin/channel.js");
+      const { sanitizeTownSessionId } = await import("./src/plugin/town-session.js");
+      await sendNudgeMessage(
+        sanitizeTownSessionId(townSessionId),
+        '[系统通知] 当前批次的居民已全部完成任务。请调用 next_step() 查看下一步指令。',
+      );
+    } catch (err) {
+      console.error('[agentshire] nudge: failed to send nudge message:', err);
+    }
+  }, NUDGE_DELAY_MS);
+}
+
+export { agentTownPlugin } from "./src/plugin/channel.js";
+export { setTownRuntime } from "./src/plugin/runtime.js";
+export { loadTownSoul, listTownSouls } from "./src/town-souls.js";
+export type { TownSoul } from "./src/town-souls.js";
+
+const TOWN_AGENT_ID = "town-steward";
+
+const pendingSpawnTasks = new Map<string, string>();
+
+function notifyGroupDiscussion(hookName: string, agentId: string, payload: Record<string, unknown>): void {
+  import("./src/plugin/group-discussion.js").then(({ hasActiveDiscussion, onCitizenResponse, onCitizenTurnEnd }) => {
+    if (!hasActiveDiscussion()) return;
+    if (hookName === "llm_output") {
+      const texts: string[] = (payload as any).assistantTexts ?? [];
+      const text = texts.length > 0 ? texts[texts.length - 1] : String((payload as any).output ?? "");
+      if (text) onCitizenResponse(agentId, text);
+    } else if (hookName === "agent_end") {
+      onCitizenTurnEnd(agentId);
+    }
+  }).catch(() => {});
+}
+
+function resolveSessionId(ctx: unknown, payload: Record<string, unknown>): string | undefined {
+  const c = (ctx ?? {}) as Record<string, unknown>;
+  return (
+    extractTownSessionId(c.sessionId) ??
+    extractTownSessionId(c.sessionKey) ??
+    extractTownSessionId(c.requesterSessionKey) ??
+    extractTownSessionId(payload.sessionId) ??
+    getActiveTownSessionId()
+  ) ?? undefined;
+}
+
+function isStewardDirect(ctx: any): boolean {
+  if (!ctx?.agentId) return true;
+  if (ctx.agentId !== TOWN_AGENT_ID) return false;
+  const sk = ctx.sessionKey as string | undefined;
+  if (sk && sk.includes(":subagent:")) return false;
+  return true;
+}
+
+function dispatchSteward(hookName: string, payload: Record<string, unknown>, ctx?: unknown): void {
+  const result = hookToAgentEvent(hookName, payload);
+  if (!result) return;
+  const sid = resolveSessionId(ctx, payload);
+  console.log(`[agentshire][session:${sid ?? "unscoped"}] hook → ${hookName}`);
+  const events = Array.isArray(result) ? result : [result];
+  for (const event of events) {
+    broadcastAgentEvent(event, sid);
+  }
+}
+
+function dispatchCitizen(hookName: string, payload: Record<string, unknown>, ctx?: unknown): void {
+  const sk = (ctx as any)?.sessionKey as string | undefined;
+  if (!sk) return;
+  const agentIdMatch = sk.match(/^agent:([^:]+):/);
+  if (!agentIdMatch) return;
+  const agentId = agentIdMatch[1];
+  const npcId = findCitizenNpcId(agentId);
+  if (!npcId) return;
+  const result = hookToAgentEvent(hookName, payload);
+  if (!result) return;
+  const sid = resolveSessionId(ctx, payload);
+  const events = Array.isArray(result) ? result : [result];
+  for (const event of events) {
+    (event as any).npcId = npcId;
+    broadcastAgentEvent(event, sid);
+  }
+
+  notifyGroupDiscussion(hookName, agentId, payload);
+}
+
+function extractAgentIdForChatBinding(ctx: any): string | undefined {
+  if (ctx?.agentId === TOWN_AGENT_ID || !ctx?.agentId) return "steward";
+  const sk = ctx?.sessionKey as string | undefined;
+  if (!sk) return undefined;
+  const m = sk.match(/^agent:([^:]+):/);
+  return m?.[1];
+}
+
+function registerHooks(api: OpenClawPluginApi): void {
+  const stewardHooks = [
+    "before_agent_start", "llm_input", "llm_output",
+    "before_tool_call", "after_tool_call", "agent_end",
+  ] as const;
+
+  for (const hookName of stewardHooks) {
+    api.on(hookName, (event: any, ctx: any) => {
+      if (!isStewardDirect(ctx)) {
+        if (hookName === 'before_agent_start') {
+          const sid = resolveSessionId(ctx, event as any);
+          const agentId = extractAgentIdForChatBinding(ctx);
+          if (sid && agentId) {
+            retryChatWatchersForBinding(sid, agentId);
+          }
+        }
+        dispatchCitizen(hookName, event as any, ctx);
+        return;
+      }
+      if (hookName === 'before_agent_start' || hookName === 'before_tool_call' || hookName === 'llm_input') {
+        if (pendingNudgeTimer) {
+          console.log('[agentshire] nudge cancelled: steward resumed on its own');
+          cancelNudge();
+        }
+      }
+      if (hookName === 'before_agent_start') {
+        const sid = resolveSessionId(ctx, event as any);
+        const agentId = extractAgentIdForChatBinding(ctx);
+        if (sid && agentId) {
+          retryChatWatchersForBinding(sid, agentId);
+        }
+      }
+      dispatchSteward(hookName, event as any, ctx);
+      if (hookName === 'agent_end') {
+        const sid = resolveSessionId(ctx, event as any);
+        if (sid) {
+          setTimeout(() => pushNewChatMessages(sid), 500);
+        }
+      }
+      if (hookName === 'before_tool_call') {
+        const toolName = String((event as any)?.toolName ?? (event as any)?.name ?? '');
+        if (toolName === 'sessions_spawn') {
+          const params = (event as any)?.params ?? (event as any)?.input ?? {};
+          const label = String(params.label ?? '');
+          const task = String(params.task ?? '');
+          if (label && task) {
+            pendingSpawnTasks.set(label, task);
+          }
+        }
+      }
+    });
+  }
+
+  api.on("subagent_spawned", (event: any, ctx: any) => {
+    const sid = resolveSessionId(ctx, event as any);
+    const label = String(event.label ?? event.displayName ?? "");
+    const cachedTask = label ? pendingSpawnTasks.get(label) : undefined;
+    if (cachedTask) {
+      event.task = cachedTask;
+      pendingSpawnTasks.delete(label);
+    }
+    dispatchSteward("subagent_spawned", event as any, ctx);
+    onSubagentSpawned(event as Record<string, unknown>, sid, (fallbackLabel, fallbackSid) => {
+      console.log(`[agentshire] fallback: marking "${fallbackLabel}" as completed`);
+      onAgentCompleted(fallbackLabel, true);
+
+      if (fallbackSid) {
+        setTimeout(() => pushSubagentCompletion(
+          String((event as any).childSessionKey ?? ""), fallbackSid), 800);
+      }
+
+      if (hasActivePlan() && isCurrentBatchDone()) {
+        if (fallbackSid) {
+          console.log('[agentshire] fallback: batch complete, scheduling nudge');
+          scheduleNudge(fallbackSid);
+        }
+      }
+    });
+    if (label) onAgentStarted(label);
+  });
+
+  api.on("subagent_ended", (event: any, ctx: any) => {
+    const trackedLabel = getLabelForSession(event as Record<string, unknown>);
+    dispatchSteward("subagent_ended", event as any, ctx);
+    onSubagentEnded(event as Record<string, unknown>);
+    const label = trackedLabel ?? String(event.label ?? event.displayName ?? "");
+    const success = String(event.outcome ?? "ok") !== "error";
+    if (label) {
+      console.log(`[agentshire] subagent_ended: label="${label}" success=${success}`);
+      onAgentCompleted(label, success);
+    }
+
+    const childKey = String(event.targetSessionKey ?? "");
+    if (childKey) {
+      const sid = resolveSessionId(ctx, event as any);
+      if (sid) {
+        setTimeout(() => pushSubagentCompletion(childKey, sid), 800);
+      }
+    }
+
+    if (hasActivePlan() && isCurrentBatchDone()) {
+      const sid = resolveSessionId(ctx, event as any);
+      if (sid) {
+        console.log('[agentshire] batch complete detected, scheduling nudge in', NUDGE_DELAY_MS, 'ms');
+        scheduleNudge(sid);
+      }
+    }
+  });
+
+  api.on("session_start", (event: any, ctx: any) => {
+    if (!isStewardDirect(ctx)) return;
+    const sid = resolveSessionId(ctx, event as any);
+    if (sid) clearEventBuffer(sid);
+    if (sid) {
+      cleanupStaleSessionPlans(sid);
+      setTimeout(() => pushNewChatMessages(sid), 200);
+    }
+    dispatchSteward("before_agent_start", {
+      ...(event as any),
+      sessionId: (ctx as any)?.sessionId ?? (event as any).sessionId ?? `oc-${Date.now()}`,
+      model: (event as any).model ?? "default",
+    }, ctx);
+  });
+
+  api.on("session_end", (event: any, ctx: any) => {
+    if (!isStewardDirect(ctx)) return;
+    dispatchSteward("session_end", event as any, ctx);
+    clearPlan();
+    cancelNudge();
+  });
+
+  api.on("message_sending", (event: any, ctx: any) => {
+    if (!isStewardDirect(ctx)) return;
+    dispatchSteward("message_sending", event as any, ctx);
+  });
+}
+
+export default {
+  id: "agentshire",
+  name: "Agentshire",
+  description: "OpenClaw plugin for building a living 3D town with social NPCs, a map editor, and a character workshop.",
+  register(api: any) {
+    setTownRuntime(api.runtime);
+    initStateDir(api.runtime.config);
+    api.registerChannel(agentTownPlugin);
+    registerHooks(api);
+    api.registerTool(createTownTools());
+
+    import("./src/plugin/auto-config.js")
+      .then((m) => m.ensureTownAgentConfig())
+      .catch((err) => console.error("[agentshire] auto-config failed:", err));
+
+    api.on("subagent_spawning", async (event: any) => {
+      try {
+        const soulId = event.soul || event.persona || event.label;
+        if (soulId) {
+          const { loadTownSoul } = await import("./src/town-souls.js");
+          const { join } = await import("node:path");
+          const { fileURLToPath } = await import("node:url");
+          const pluginDir = join(fileURLToPath(import.meta.url), "..");
+          const townSoul = loadTownSoul(soulId, pluginDir);
+          if (townSoul.soul) return { prependSystemContext: townSoul.soul };
+        }
+      } catch (err) {
+        console.error("[agentshire] Failed to load citizen soul:", err);
+      }
+    });
+
+    api.registerService({
+      id: "agentshire-frontend",
+      start: async () => {
+        const config = api.pluginConfig as Record<string, unknown> | undefined;
+        const townPort = (config?.townPort as number) ?? 55210;
+        try {
+          const { createServer } = await import("node:http");
+          const { join } = await import("node:path");
+          const { readFileSync, existsSync, statSync } = await import("node:fs");
+          const { fileURLToPath } = await import("node:url");
+          const pluginDir = join(fileURLToPath(import.meta.url), "..");
+          const distDir = join(pluginDir, "town-frontend", "dist");
+          if (!existsSync(distDir)) {
+            console.log(`[agentshire] Town frontend not built yet. Run: cd ${join(pluginDir, "town-frontend")} && npm run build`);
+            return;
+          }
+          ensureEditorDirs(pluginDir);
+
+          const server = createServer(async (req, res) => {
+            let urlPath = new URL(req.url ?? "/", `http://localhost:${townPort}`).pathname;
+            if (urlPath === "/" || urlPath === "") urlPath = "/index.html";
+
+            // Editor routes: ext-assets, citizen-workshop, custom-assets
+            if (await handleEditorRequest(req, res, pluginDir)) return;
+
+            // Steward workspace: projects & tasks
+            const stewardPrefix = "/steward-workspace/";
+            if (urlPath.startsWith(stewardPrefix)) {
+              const { stateDir } = await import("./src/plugin/paths.js");
+              const relPath = decodeURIComponent(urlPath.slice(stewardPrefix.length));
+              const wsFile = join(stateDir(), "workspace-town-steward", relPath);
+              if (existsSync(wsFile) && statSync(wsFile).isFile()) {
+                const ext = wsFile.substring(wsFile.lastIndexOf("."));
+                res.writeHead(200, {
+                  "Content-Type": MIME_TYPES[ext] ?? "application/octet-stream",
+                  "Access-Control-Allow-Origin": "*",
+                });
+                res.end(readFileSync(wsFile));
+                return;
+              }
+            }
+
+            // Fallback: serve from dist/
+            const filePath = join(distDir, decodeURIComponent(urlPath));
+            if (existsSync(filePath) && statSync(filePath).isFile()) {
+              const ext = filePath.substring(filePath.lastIndexOf("."));
+              res.writeHead(200, {
+                "Content-Type": MIME_TYPES[ext] ?? "application/octet-stream",
+                "Access-Control-Allow-Origin": "*",
+              });
+              res.end(readFileSync(filePath));
+              return;
+            }
+
+            // SPA fallback for HTML pages
+            const htmlFile = urlPath.endsWith(".html") ? join(distDir, urlPath) : null;
+            if (htmlFile && existsSync(htmlFile)) {
+              res.writeHead(200, { "Content-Type": "text/html" });
+              res.end(readFileSync(htmlFile));
+              return;
+            }
+            const indexPath = join(distDir, "index.html");
+            if (existsSync(indexPath)) {
+              res.writeHead(200, { "Content-Type": "text/html" });
+              res.end(readFileSync(indexPath));
+            } else {
+              res.writeHead(404);
+              res.end("Not Found");
+            }
+          });
+          httpServer = server;
+          server.listen(townPort, () => console.log(`[agentshire] HTTP server listening on port ${townPort}`));
+          server.on("error", (err: NodeJS.ErrnoException) => {
+            if (err.code === "EADDRINUSE") {
+              console.error(`[agentshire] ❌ HTTP port ${townPort} is already in use.`);
+              console.error(`[agentshire]    Fix: stop the process using this port (vite dev server?), or change townPort in openclaw.json:`);
+              console.error(`[agentshire]    { "plugins": { "entries": { "agentshire": { "config": { "townPort": ${townPort + 1} } } } } }`);
+            } else {
+              console.error("[agentshire] Frontend server error:", err);
+            }
+          });
+        } catch (err) {
+          console.error("[agentshire] Failed to start town frontend server:", err);
+        }
+      },
+      stop: async () => {
+        stopAllWatchers();
+        if (httpServer) {
+          httpServer.close();
+          httpServer = null;
+        }
+      },
+    });
+  },
+};

package/openclaw.plugin.json

@@ -0,0 +1,27 @@
+{
+  "id": "agentshire",
+  "name": "Agentshire",
+  "description": "OpenClaw plugin for building a living 3D town with social NPCs, a map editor, and a character workshop.",
+  "channels": ["agentshire"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "wsPort": {
+        "type": "number",
+        "default": 55211,
+        "description": "WebSocket port for town frontend connection"
+      },
+      "townPort": {
+        "type": "number",
+        "default": 55210,
+        "description": "HTTP port to serve the town frontend"
+      },
+      "autoLaunch": {
+        "type": "boolean",
+        "default": true,
+        "description": "Automatically open town in browser on start"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "agentshire",
+  "version": "1.0.0",
+  "description": "OpenClaw/QClaw plugin for building a living 3D town with social NPCs, a map editor, and a character workshop.",
+  "main": "./index.ts",
+  "exports": {
+    ".": "./index.ts"
+  },
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "index.ts",
+    ".npmrc",
+    "src/",
+    "town-frontend/dist/",
+    "town-souls/",
+    "town-workspace/",
+    "openclaw.plugin.json",
+    "README.md",
+    "README.zh-CN.md",
+    "CHANGELOG.md",
+    "THIRD_PARTY_NOTICES.md",
+    "VISION.md",
+    "ROADMAP.md",
+    "LICENSE",
+    "!**/*.map"
+  ],
+  "author": "Agentshire Contributors",
+  "homepage": "https://github.com/Agentshire/Agentshire#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Agentshire/Agentshire.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Agentshire/Agentshire/issues"
+  },
+  "keywords": [
+    "openclaw",
+    "ai-agents",
+    "multi-agent",
+    "generative-agents",
+    "npc",
+    "threejs",
+    "3d",
+    "simulation",
+    "game",
+    "visualization",
+    "low-poly",
+    "typescript",
+    "open-source",
+    "level-editor",
+    "character-creator"
+  ],
+  "scripts": {
+    "build:town": "cd town-frontend && npm install && npm run build",
+    "build": "npm run build:town",
+    "dev:town": "cd town-frontend && npm run dev",
+    "postinstall": "echo '' && echo '  🏘️  Agentshire installed successfully!' && echo '' && echo '  Next: (re)start the OpenClaw Gateway to activate the plugin.' && echo '        The town will open automatically in your browser.' && echo ''",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@gltf-transform/core": "^4.3.0",
+    "@gltf-transform/extensions": "^4.3.0",
+    "@gltf-transform/functions": "^4.3.0",
+    "jsonrepair": "^3.13.3",
+    "ws": "^8.16.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">= 2026.3.7"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.10",
+    "typescript": "^5.4.0",
+    "vitest": "^4.1.0"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "channel": {
+      "id": "agentshire",
+      "label": "Agentshire",
+      "selectionLabel": "Agentshire (3D Visualization)",
+      "docsPath": "/channels/agentshire",
+      "docsLabel": "agentshire",
+      "blurb": "Visualize your AI agents as NPCs in an interactive 3D low-poly town. Watch them work, chat, and collaborate in real-time.",
+      "order": 100
+    },
+    "install": {
+      "npmSpec": "agentshire",
+      "localPath": "extensions/agentshire",
+      "defaultChoice": "npm"
+    }
+  }
+}