@nocville/npc 0.2.3 → 0.3.0

package/README.md

@@ -140,15 +140,23 @@ on your map automatically and despawns when you press Ctrl-C. Once you've run
 #   --debug                  Verbose logging
 ```
 
-| NPC                     | What it does                                       | Example                                                |
-| ----------------------- | -------------------------------------------------- | ------------------------------------------------------ |
-| `system-monitor`        | CPU / memory / disk / load with sparklines         | `nocville-npc system-monitor --cpu-warn=75`            |
-| `internet-connectivity` | DNS, HTTP and TCP latency checks                   | `nocville-npc internet-connectivity`                   |
-| `process-watcher`       | Watches named processes, calls out deaths          | `nocville-npc process-watcher --processes=nginx,redis` |
-| `log-watcher`           | Error bursts in log files, last lines on a monitor | `nocville-npc log-watcher --files=/var/log/app.log`    |
-| `receptionist`          | Time and weather at the entrance, greets players   | `nocville-npc receptionist --location="Berlin"`        |
-| `github-watcher`        | New commits on a commit board                      | `nocville-npc github-watcher --repo=owner/name`        |
-| `web-page-watcher`      | A web page rendered as a pixel-art TV              | `nocville-npc web-page-watcher --url=https://…`        |
+| NPC                      | What it does                                               | Example                                                |
+| ------------------------ | ---------------------------------------------------------- | ------------------------------------------------------ |
+| `system-monitor`         | CPU / memory / disk / load with sparklines                 | `nocville-npc system-monitor --cpu-warn=75`            |
+| `internet-connectivity`  | DNS, HTTP and TCP latency checks                           | `nocville-npc internet-connectivity`                   |
+| `process-watcher`        | Watches named processes, calls out deaths                  | `nocville-npc process-watcher --processes=nginx,redis` |
+| `log-watcher`            | Error bursts in log files, last lines on a monitor         | `nocville-npc log-watcher --files=/var/log/app.log`    |
+| `receptionist`           | Lobby greetings, check-ins and front desk jokes            | `nocville-npc receptionist`                            |
+| `security`               | Indoor/outdoor patrols and exterior door watch             | `nocville-npc security`                                |
+| `janitor`                | Mops suspicious spots and complains about bugs everywhere. | `nocville-npc janitor`                                 |
+| `barista`                | Your coffee order is getting a little out of hand.         | `nocville-npc barista`                                 |
+| `office-cat`             | Your desk belongs to the cat now.                          | `nocville-npc office-cat`                              |
+| `office-dog`             | Chief morale officer. Easily distracted.                   | `nocville-npc office-dog`                              |
+| `plant-caretaker`        | Every fern deserves a performance review.                  | `nocville-npc plant-caretaker`                         |
+| `it-technician`          | Have you tried turning it off and on again?                | `nocville-npc it-technician`                           |
+| `out-of-touch-executive` | Big ideas. Long coffee breaks. Your overtime.              | `nocville-npc out-of-touch-executive`                  |
+| `github-watcher`         | New commits on a commit board                              | `nocville-npc github-watcher --repo=owner/name`        |
+| `web-page-watcher`       | A web page rendered as a pixel-art TV                      | `nocville-npc web-page-watcher --url=https://…`        |
 
 Run `nocville-npc --help` to see every flag. Poll intervals below 5 seconds are raised to 5
 seconds. A few notes:
@@ -160,16 +168,28 @@ seconds. A few notes:
   `--latency-hosts` take comma-separated lists; latency targets accept `host:port` or
   `[ipv6]:port`. `--timeout=<ms>` bounds each check (default 5000).
 - **process-watcher**: matches executable names, so `--processes=python` also finds `python3.11`
-  but `sh` does not match `bash`. Use a full path to match one binary exactly. macOS and Linux
-  only.
+  but `sh` does not match `bash`. Works on macOS and Linux via `ps`, and Windows via
+  PowerShell/CIM performance counters. Windows accepts names with or without `.exe` and
+  reports CPU as a percentage of total machine capacity. Full-path matching is available
+  where the OS reports paths (macOS); use executable names on Windows and Linux.
 - **log-watcher**: `--error-pattern="ERROR|FATAL" --window=300 --error-warn=5 --error-crit=20`.
   Files are followed across log rotation and may be created after the watcher starts. Lines
   shown in the office have anything that looks like a secret (tokens, passwords, keys, URL
   credentials) redacted, but treat the screen as visible to your whole team.
-- **receptionist**: weather comes from the keyless open-meteo API. Set the place with
-  `--lat=52.5 --lon=13.4` or `--location=…`. Without either, it estimates your location from
-  your public IP via ipapi.co; pass `--no-ip-geo` to turn that off and show only the time. Add
-  `--fahrenheit` for °F.
+- **receptionist**: claims a free desk in a room named Lobby, Reception, Foyer or Entrance
+  (or its assigned work room). Without a desk, uses an open spot. Greets each arrival,
+  checks on a teammate every 2–4 minutes and makes a desk-side joke every 1–2 minutes.
+  No screen, weather requests or geolocation; old weather options are accepted but ignored.
+- **security**: continuously visits rooms and reachable outdoor areas, pausing beside
+  exterior doors for 15–30 seconds. Does not claim a desk. An explicit work-room rule
+  still confines its route, so leave it unassigned for office-wide rounds.
+- **office characters**: `janitor`, `barista`, `office-cat`, `office-dog`,
+  `plant-caretaker`, `it-technician` and `out-of-touch-executive` run without screens or
+  external service credentials. They share the usual API key, name, service ID and map
+  options. Run each as its own process. Their routes and conversation are synchronized by
+  the server, and work-room rules apply. Missing furniture or coworkers cause quiet walks
+  or floor rests instead. The technician's reboots and executive's requests are pretend.
+  Animals have custom walk, sleep and tail animations; staff carry their tools or coffee.
 - **github-watcher**: uses ETag polling. Set `GITHUB_TOKEN` for private repos and a higher rate
   limit (`--token` also works, but flags are visible to other users in the process list).
   Without a token it polls every 90 seconds to stay within GitHub's 60 requests per hour.

package/dist/cjs/cli.js

@@ -82,7 +82,15 @@ Monitoring NPC types:
   internet-connectivity   Monitor network connectivity
   process-watcher         Watch for running processes
   log-watcher             Watch log files for errors
-  receptionist            Greeter showing time + local weather
+  receptionist            Lobby greeter with office check-ins and jokes
+  security                Indoor/outdoor patrols and exterior door watch
+  janitor                 Mops suspicious spots and hunts office bugs
+  barista                 Takes increasingly absurd coffee orders
+  office-cat              Naps on desks and supervises keyboards
+  office-dog              Naps, barks at coworkers and runs around
+  plant-caretaker         Waters plants and reviews their performance
+  it-technician           Inspects tech gear and recommends reboots
+  out-of-touch-executive  Interrupts coworkers between long lounge breaks
   github-watcher          Call out new commits on a repo
   web-page-watcher        Render a watched web page as a pixel-art TV
 
@@ -137,13 +145,8 @@ Log Watcher Options:
   --error-crit=<n>        Error count for critical status (default: 20)
   --report-interval=<ms>  Report interval in ms (default: 15000)
 
-Receptionist Options:
-  --poll-interval=<ms>    Clock tick in ms (default: 60000)
-  --lat=<n> --lon=<n>     Explicit coordinates for weather
-  --location=<name>       Place name to geocode (open-meteo)
-  --no-ip-geo             Without --lat/--lon or --location, don't look up
-                          this machine's IP location (ipapi.co); show time only
-  --fahrenheit            Show temperature in °F (default: °C)
+Office Character Options:
+  --poll-interval=<ms>    Heartbeat interval in ms (default: 60000)
 
 GitHub Watcher Options:
   --repo=<owner/name>     Repository to watch (required)
@@ -396,6 +399,37 @@ async function main() {
             await npc.start();
             break;
         }
+        case 'security': {
+            if (!config.serviceId)
+                config.serviceId = 'security';
+            const { SecurityNPC } = await Promise.resolve().then(() => __importStar(require('./npcs/security/index.js')));
+            const npc = new SecurityNPC({
+                ...config,
+                pollInterval: (0, config_js_1.numberFlag)(parsed.flags, 'poll-interval'),
+            });
+            logger.info('Starting security NPC');
+            await npc.start();
+            break;
+        }
+        case 'janitor':
+        case 'barista':
+        case 'office-cat':
+        case 'office-dog':
+        case 'plant-caretaker':
+        case 'it-technician':
+        case 'out-of-touch-executive': {
+            if (!config.serviceId)
+                config.serviceId = parsed.command;
+            const { OFFICE_CHARACTER_NPCS } = await Promise.resolve().then(() => __importStar(require('./npcs/office-characters/index.js')));
+            const NPCClass = OFFICE_CHARACTER_NPCS[parsed.command];
+            const npc = new NPCClass({
+                ...config,
+                pollInterval: (0, config_js_1.numberFlag)(parsed.flags, 'poll-interval'),
+            });
+            logger.info(`Starting ${parsed.command} NPC`);
+            await npc.start();
+            break;
+        }
         case 'github-watcher': {
             const repo = (0, config_js_1.stringFlag)(parsed.flags, 'repo');
             if (!repo) {

package/dist/cjs/core/base-npc.js

@@ -131,6 +131,13 @@ class BaseNPC {
             alertConfig: { heartbeatInterval: this.heartbeatSeconds },
             map: this.config.map,
         });
+        // An observer cannot interrupt monitoring or retries.
+        try {
+            this.config.onPushResult?.({ success: result.success, error: result.error });
+        }
+        catch {
+            /* observer only */
+        }
         if (!result.success) {
             this.reportPushFailure(result.error);
         }

package/dist/cjs/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReceptionistNPC = exports.LogWatcherNPC = exports.ProcessWatcherNPC = exports.InternetConnectivityNPC = exports.ensureSessionFilterTemplate = exports.sessionPublishDecision = exports.sessionFilterPath = exports.loadSessionFilter = exports.pixelDevice = exports.pixelArtFromPng = exports.encodePixelArt = exports.userConfigPath = exports.saveUserConfig = exports.loadUserConfig = exports.redactSecrets = exports.shortPath = exports.shortCommand = exports.describeToolUse = exports.CodexWatcher = exports.parseRolloutLine = exports.uninstallCodexHooks = exports.setupCodexHooks = exports.codexTransition = exports.handleCodexHookEvent = exports.handleCodexCommand = exports.claudeTransition = exports.processHookEvent = exports.uninstallHooks = exports.setupHooks = exports.handleHookEvent = exports.handleClaudeCodeCommand = exports.ClaudeCodeNPC = exports.SystemMonitorNPC = exports.pushHistory = exports.statusColor = exports.NpcConfigError = exports.sanitizeText = exports.truncate = exports.moodForStatus = exports.worstStatus = exports.evaluateThreshold = exports.numberFlag = exports.boolFlag = exports.stringFlag = exports.resolveConfig = exports.parseArgs = exports.Logger = exports.EventNPC = exports.PollingNPC = exports.BaseNPC = void 0;
-exports.normalizeCursorEvent = exports.isCursorInvocation = exports.CURSOR_HOOK_EVENTS = exports.installCursorHooksInto = exports.uninstallCursorHooks = exports.setupCursorHooks = exports.handleCursorHookEvent = exports.cursorServiceId = exports.CURSOR_ADAPTER = exports.CURSOR_DEFAULTS = exports.GEMINI_HOOK_EVENTS = exports.installGeminiHooksInto = exports.uninstallGeminiHooks = exports.setupGeminiHooks = exports.handleGeminiHookEvent = exports.geminiServiceId = exports.geminiTransition = exports.GEMINI_ADAPTER = exports.GEMINI_DEFAULTS = exports.WebPageWatcherNPC = exports.GitHubWatcherNPC = void 0;
+exports.OFFICE_CHARACTER_NPCS = exports.OutOfTouchExecutiveNPC = exports.ITTechnicianNPC = exports.PlantCaretakerNPC = exports.OfficeDogNPC = exports.OfficeCatNPC = exports.BaristaNPC = exports.JanitorNPC = exports.SecurityNPC = exports.normalizeCursorEvent = exports.isCursorInvocation = exports.CURSOR_HOOK_EVENTS = exports.installCursorHooksInto = exports.uninstallCursorHooks = exports.setupCursorHooks = exports.handleCursorHookEvent = exports.cursorServiceId = exports.CURSOR_ADAPTER = exports.CURSOR_DEFAULTS = exports.GEMINI_HOOK_EVENTS = exports.installGeminiHooksInto = exports.uninstallGeminiHooks = exports.setupGeminiHooks = exports.handleGeminiHookEvent = exports.geminiServiceId = exports.geminiTransition = exports.GEMINI_ADAPTER = exports.GEMINI_DEFAULTS = exports.WebPageWatcherNPC = exports.GitHubWatcherNPC = void 0;
 // Core
 var base_npc_js_1 = require("./core/base-npc.js");
 Object.defineProperty(exports, "BaseNPC", { enumerable: true, get: function () { return base_npc_js_1.BaseNPC; } });
@@ -100,4 +100,15 @@ Object.defineProperty(exports, "CURSOR_HOOK_EVENTS", { enumerable: true, get: fu
 var normalize_js_1 = require("./npcs/cursor/normalize.js");
 Object.defineProperty(exports, "isCursorInvocation", { enumerable: true, get: function () { return normalize_js_1.isCursorInvocation; } });
 Object.defineProperty(exports, "normalizeCursorEvent", { enumerable: true, get: function () { return normalize_js_1.normalizeCursorEvent; } });
+var index_js_12 = require("./npcs/security/index.js");
+Object.defineProperty(exports, "SecurityNPC", { enumerable: true, get: function () { return index_js_12.SecurityNPC; } });
+var index_js_13 = require("./npcs/office-characters/index.js");
+Object.defineProperty(exports, "JanitorNPC", { enumerable: true, get: function () { return index_js_13.JanitorNPC; } });
+Object.defineProperty(exports, "BaristaNPC", { enumerable: true, get: function () { return index_js_13.BaristaNPC; } });
+Object.defineProperty(exports, "OfficeCatNPC", { enumerable: true, get: function () { return index_js_13.OfficeCatNPC; } });
+Object.defineProperty(exports, "OfficeDogNPC", { enumerable: true, get: function () { return index_js_13.OfficeDogNPC; } });
+Object.defineProperty(exports, "PlantCaretakerNPC", { enumerable: true, get: function () { return index_js_13.PlantCaretakerNPC; } });
+Object.defineProperty(exports, "ITTechnicianNPC", { enumerable: true, get: function () { return index_js_13.ITTechnicianNPC; } });
+Object.defineProperty(exports, "OutOfTouchExecutiveNPC", { enumerable: true, get: function () { return index_js_13.OutOfTouchExecutiveNPC; } });
+Object.defineProperty(exports, "OFFICE_CHARACTER_NPCS", { enumerable: true, get: function () { return index_js_13.OFFICE_CHARACTER_NPCS; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/npcs/agent-common/shim.js

@@ -83,13 +83,19 @@ try {
 if (neutral) process.stdout.write('{}\\n');
 `;
 function installHookShim(nodePath, cliPath) {
+    // Desktop ships this same CLI with Electron's Node runtime. Keep the flag in
+    // the launcher (never globally), inherited by flush/watchdog child processes.
+    const electron = !!process.versions['electron'];
     writeChanged((0, exports.RUNTIME_POINTER)(), JSON.stringify({ node: nodePath, cli: cliPath }, null, 2) + '\n', 0o600);
     writeChanged((0, node_path_1.join)((0, node_path_1.dirname)((0, exports.RUNTIME_POINTER)()), 'node-path'), nodePath + '\n', 0o600);
     writeChanged((0, node_path_1.join)((0, node_path_1.dirname)((0, exports.SHIM_PATH)()), 'launch.cjs'), LAUNCHER, 0o600);
-    writeChanged((0, exports.SHIM_PATH)(), SHIM, 0o755);
+    writeChanged((0, exports.SHIM_PATH)(), electron ? SHIM.replace('exec "$NODE"', 'export ELECTRON_RUN_AS_NODE=1\nexec "$NODE"') : SHIM, 0o755);
     (0, node_fs_1.chmodSync)((0, exports.SHIM_PATH)(), 0o755);
     // Both launchers use the same bootstrap, including imported-Cursor detection.
-    writeChanged((0, exports.SHIM_PATH)() + '.cmd', WINDOWS_SHIM.replace(/\n/g, '\r\n'), 0o755);
+    const windowsShim = electron
+        ? WINDOWS_SHIM.replace(':launch\n', ':launch\nset "ELECTRON_RUN_AS_NODE=1"\n')
+        : WINDOWS_SHIM;
+    writeChanged((0, exports.SHIM_PATH)() + '.cmd', windowsShim.replace(/\n/g, '\r\n'), 0o755);
     (0, runtime_js_1.pruneOldRuntimes)((0, node_path_1.dirname)((0, exports.RUNTIME_POINTER)()));
     return (0, exports.SHIM_PATH)();
 }

package/dist/cjs/npcs/office-characters/index.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OFFICE_CHARACTER_NPCS = exports.OutOfTouchExecutiveNPC = exports.ITTechnicianNPC = exports.PlantCaretakerNPC = exports.OfficeDogNPC = exports.OfficeCatNPC = exports.BaristaNPC = exports.JanitorNPC = void 0;
+const polling_npc_js_1 = require("../../core/polling-npc.js");
+/** Quiet heartbeats; the authoritative server drives routines and conversation. */
+class OfficeCharacterNPC extends polling_npc_js_1.PollingNPC {
+    constructor(config) {
+        super({ ...config, pollInterval: config.pollInterval ?? 60_000 });
+    }
+    get archetype() {
+        return 'custom';
+    }
+    get behavior() {
+        return { role: this.name, activity: 'idle', idlePose: 'stand' };
+    }
+    async collect() {
+        return { status: 'healthy', mood: 'happy', message: '', metrics: {} };
+    }
+}
+class JanitorNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'janitor';
+    }
+    get defaultDisplayName() {
+        return 'Janitor';
+    }
+}
+exports.JanitorNPC = JanitorNPC;
+class BaristaNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'barista';
+    }
+    get defaultDisplayName() {
+        return 'Barista';
+    }
+}
+exports.BaristaNPC = BaristaNPC;
+class OfficeCatNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'office-cat';
+    }
+    get defaultDisplayName() {
+        return 'Office Cat';
+    }
+}
+exports.OfficeCatNPC = OfficeCatNPC;
+class OfficeDogNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'office-dog';
+    }
+    get defaultDisplayName() {
+        return 'Office Dog';
+    }
+}
+exports.OfficeDogNPC = OfficeDogNPC;
+class PlantCaretakerNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'plant-caretaker';
+    }
+    get defaultDisplayName() {
+        return 'Plant Caretaker';
+    }
+}
+exports.PlantCaretakerNPC = PlantCaretakerNPC;
+class ITTechnicianNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'it-technician';
+    }
+    get defaultDisplayName() {
+        return 'IT Technician';
+    }
+}
+exports.ITTechnicianNPC = ITTechnicianNPC;
+class OutOfTouchExecutiveNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'out-of-touch-executive';
+    }
+    get defaultDisplayName() {
+        return 'Out-of-Touch Executive';
+    }
+}
+exports.OutOfTouchExecutiveNPC = OutOfTouchExecutiveNPC;
+exports.OFFICE_CHARACTER_NPCS = {
+    janitor: JanitorNPC,
+    barista: BaristaNPC,
+    'office-cat': OfficeCatNPC,
+    'office-dog': OfficeDogNPC,
+    'plant-caretaker': PlantCaretakerNPC,
+    'it-technician': ITTechnicianNPC,
+    'out-of-touch-executive': OutOfTouchExecutiveNPC,
+};
+//# sourceMappingURL=index.js.map

package/dist/cjs/npcs/process-watcher/index.js

@@ -16,7 +16,6 @@ class ProcessWatcherNPC extends polling_npc_js_1.PollingNPC {
     cpuHistories = new Map();
     previousRunning = null;
     constructor(config) {
-        (0, errors_js_1.assertPosix)('process-watcher', 'It relies on the POSIX `ps` command; run it under WSL/Linux, or use system-monitor instead.');
         super(config);
         this.processes = [...new Set(config.processes.map((p) => p.trim()).filter(Boolean))];
         if (this.processes.length === 0) {

package/dist/cjs/npcs/process-watcher/process-scanner.js

@@ -4,10 +4,13 @@ exports.detectTransitions = detectTransitions;
 exports.parsePsOutput = parsePsOutput;
 exports.matchesName = matchesName;
 exports.listProcesses = listProcesses;
+exports.parseWindowsProcesses = parseWindowsProcesses;
 exports.matchProcesses = matchProcesses;
 exports.scanProcesses = scanProcesses;
 const node_child_process_1 = require("node:child_process");
 const node_util_1 = require("node:util");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
 const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
 /** Bounds on the `ps` call: a wedged or enormous process table can't stall or flood us. */
 const PS_TIMEOUT_MS = 5000;
@@ -60,10 +63,10 @@ function parsePsOutput(stdout) {
  * Unlike a substring match, `sh` does not match `bash` or `ssh-agent`.
  */
 function matchesName(comm, searchName) {
-    if (searchName.includes('/'))
+    if (/[\\/]/.test(searchName))
         return comm === searchName;
-    const base = (comm.split('/').pop() ?? comm).toLowerCase();
-    const name = searchName.toLowerCase();
+    const base = (comm.split(/[\\/]/).pop() ?? comm).toLowerCase().replace(/\.exe$/, '');
+    const name = searchName.toLowerCase().replace(/\.exe$/, '');
     if (base === name)
         return true;
     if (name.length > LINUX_COMM_LEN && base === name.slice(0, LINUX_COMM_LEN))
@@ -72,6 +75,18 @@ function matchesName(comm, searchName) {
 }
 /** List every process. Throws if `ps` fails — callers must not read that as "all dead". */
 async function listProcesses() {
+    if (process.platform === 'win32') {
+        // Fixed command, no user strings interpolated. Performance counters report a
+        // sampling interval (Get-Process.CPU is lifetime CPU seconds, not a percent).
+        const executable = (0, node_path_1.join)(process.env['SystemRoot'] || 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+        const { stdout } = await execFileAsync(executable, [
+            '-NoProfile',
+            '-NonInteractive',
+            '-Command',
+            '$ErrorActionPreference="Stop"; Get-CimInstance Win32_PerfFormattedData_PerfProc_Process | Select-Object IDProcess,Name,PercentProcessorTime,WorkingSetPrivate | ConvertTo-Json -Compress',
+        ], { timeout: PS_TIMEOUT_MS, maxBuffer: PS_MAX_BUFFER, windowsHide: true });
+        return parseWindowsProcesses(stdout, (0, node_os_1.cpus)().length);
+    }
     const { stdout } = await execFileAsync('ps', ['-eo', 'pid=,pcpu=,rss=,comm='], {
         timeout: PS_TIMEOUT_MS,
         maxBuffer: PS_MAX_BUFFER,
@@ -80,6 +95,29 @@ async function listProcesses() {
     });
     return parsePsOutput(stdout);
 }
+/** Windows instance suffixes (#1, #2) distinguish copies of the same executable. */
+function parseWindowsProcesses(stdout, cores = 1) {
+    const value = JSON.parse(stdout.replace(/^\uFEFF/, ''));
+    const rows = Array.isArray(value) ? value : value ? [value] : [];
+    return rows.flatMap((row) => {
+        const pid = Number(row.IDProcess);
+        const cpu = Number(row.PercentProcessorTime);
+        const bytes = Number(row.WorkingSetPrivate);
+        if (!(pid > 0) ||
+            !Number.isFinite(cpu) ||
+            !Number.isFinite(bytes) ||
+            typeof row.Name !== 'string')
+            return [];
+        return [
+            {
+                pid,
+                cpu: cpu / Math.max(1, cores),
+                memKb: bytes / 1024,
+                comm: row.Name.replace(/#\d+$/, ''),
+            },
+        ];
+    });
+}
 /** Summarise each watched name against a process list (CPU and memory summed per name). */
 function matchProcesses(names, entries) {
     return names.map((name) => {
@@ -100,7 +138,7 @@ function matchProcesses(names, entries) {
 }
 /**
  * Scan for processes by name and return their status and resource usage.
- * Works on macOS and Linux via `ps`. Throws when the process list is unavailable.
+ * Uses `ps` on macOS/Linux and CIM on Windows. Throws when the process list is unavailable.
  */
 async function scanProcesses(names) {
     return matchProcesses(names, await listProcesses());

package/dist/cjs/npcs/receptionist/index.js

@@ -2,36 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReceptionistNPC = void 0;
 const polling_npc_js_1 = require("../../core/polling-npc.js");
-const errors_js_1 = require("../../core/errors.js");
-const defaults_js_1 = require("./defaults.js");
-const weather_js_1 = require("./weather.js");
 class ReceptionistNPC extends polling_npc_js_1.PollingNPC {
-    explicitCoords;
-    location;
-    fahrenheit;
-    ipGeo;
-    coords = null;
-    /** Earliest time to retry geocoding / IP geo after a failure. */
-    nextGeoAttempt = 0;
-    weather = null;
-    weatherFetchedAt = 0;
-    /** Earliest time to retry the weather after a failure. */
-    nextWeatherAttempt = 0;
     constructor(config) {
-        super({ ...config, pollInterval: config.pollInterval ?? defaults_js_1.DEFAULTS.pollInterval });
-        if ((config.lat === undefined) !== (config.lon === undefined)) {
-            throw new errors_js_1.NpcConfigError('--lat and --lon must be given together');
-        }
-        if (config.lat !== undefined && !(0, weather_js_1.validCoords)(config.lat, config.lon)) {
-            throw new errors_js_1.NpcConfigError('--lat must be within ±90 and --lon within ±180');
-        }
-        this.explicitCoords =
-            config.lat !== undefined && config.lon !== undefined
-                ? { lat: config.lat, lon: config.lon }
-                : null;
-        this.location = config.location?.trim() || undefined;
-        this.fahrenheit = config.fahrenheit ?? false;
-        this.ipGeo = config.ipGeo ?? true;
+        super({ ...config, pollInterval: config.pollInterval ?? 60_000 });
     }
     get name() {
         return 'receptionist';
@@ -44,102 +17,16 @@ class ReceptionistNPC extends polling_npc_js_1.PollingNPC {
     }
     get behavior() {
         return {
+            role: 'receptionist',
+            activity: 'idle',
             greetPlayers: true,
-            patrol: { everyMinutes: [15, 30], stops: 5 },
             idle: 'stay',
-            home: { near: 'entrance' },
-        };
-    }
-    get companion() {
-        return {
-            screenType: 'welcome-sign',
-            size: { w: 2, h: 1 },
-            placement: 'adjacent-wall',
-            label: 'Welcome',
+            idlePose: 'sit',
         };
     }
     async collect() {
-        await this.refreshWeather();
-        const now = new Date();
-        const { day, date, time } = (0, weather_js_1.formatClock)(now);
-        const values = [
-            { label: 'time', value: time },
-            { label: 'day', value: day },
-            { label: 'date', value: date },
-        ];
-        let message = `${day} ${time}`;
-        const metrics = { weather_ok: this.weather ? 1 : 0 };
-        if (this.weather) {
-            const temp = this.fahrenheit
-                ? `${(0, weather_js_1.toFahrenheit)(this.weather.tempC)}°F`
-                : `${this.weather.tempC}°C`;
-            message += ` • ${temp} ${this.weather.text}`;
-            values.push({ label: 'temp', value: temp }, { label: 'condition', value: this.weather.text }, { label: 'icon', value: this.weather.icon });
-            metrics['temp_c'] = this.weather.tempC;
-            metrics['weather_code'] = this.weather.code;
-            metrics['wind_kph'] = this.weather.windKph;
-        }
-        // The receptionist is a greeter/clock — it stays healthy even when weather
-        // is unavailable (degraded time-only mode).
-        return {
-            status: 'healthy',
-            mood: 'happy',
-            message,
-            screenData: { layout: 'welcome-sign', values },
-            metrics,
-        };
-    }
-    async refreshWeather() {
-        const now = Date.now();
-        if (!this.coords)
-            await this.resolveCoords(now);
-        // Don't show a reading that has gone stale through repeated failures.
-        if (this.weather && now - this.weatherFetchedAt > defaults_js_1.DEFAULTS.weatherMaxAgeMs) {
-            this.weather = null;
-        }
-        if (!this.coords || now < this.nextWeatherAttempt)
-            return;
-        if (this.weather && now - this.weatherFetchedAt < defaults_js_1.DEFAULTS.weatherRefreshMs)
-            return;
-        const w = await (0, weather_js_1.fetchWeather)(this.coords, defaults_js_1.DEFAULTS.fetchTimeoutMs);
-        if (w) {
-            this.weather = w;
-            this.weatherFetchedAt = now;
-        }
-        else {
-            this.nextWeatherAttempt = now + defaults_js_1.DEFAULTS.retryBackoffMs;
-        }
-    }
-    async resolveCoords(now) {
-        if (this.explicitCoords) {
-            this.coords = this.explicitCoords;
-            return;
-        }
-        // Back off after a failure rather than hitting the keyless endpoints every tick.
-        if (now < this.nextGeoAttempt)
-            return;
-        this.nextGeoAttempt = now + defaults_js_1.DEFAULTS.retryBackoffMs;
-        if (this.location) {
-            this.coords = await (0, weather_js_1.geocodeLocation)(this.location, defaults_js_1.DEFAULTS.fetchTimeoutMs);
-            if (this.coords)
-                return;
-            this.logger.warn(`Could not geocode "${this.location}"` + (this.ipGeo ? ', falling back to IP geo' : ''));
-        }
-        if (!this.ipGeo) {
-            if (!this.location) {
-                this.nextGeoAttempt = Infinity; // nothing to resolve, ever
-                this.logger.info('No location set and IP geolocation disabled: time-only mode');
-            }
-            return;
-        }
-        this.coords = await (0, weather_js_1.autoGeo)(defaults_js_1.DEFAULTS.fetchTimeoutMs);
-        if (this.coords) {
-            this.logger.info("Weather location estimated from this machine's IP via ipapi.co " +
-                '(set --location or --lat/--lon, or pass --no-ip-geo to disable)');
-        }
-        else {
-            this.logger.warn('Weather geo unavailable — running in time-only mode for now');
-        }
+        // The server handles conversation and movement. Heartbeats stay quiet.
+        return { status: 'healthy', mood: 'happy', message: '', metrics: {} };
     }
 }
 exports.ReceptionistNPC = ReceptionistNPC;

package/dist/cjs/npcs/security/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecurityNPC = void 0;
+const polling_npc_js_1 = require("../../core/polling-npc.js");
+class SecurityNPC extends polling_npc_js_1.PollingNPC {
+    constructor(config) {
+        super({ ...config, pollInterval: config.pollInterval ?? 60_000 });
+    }
+    get name() {
+        return 'security';
+    }
+    get defaultDisplayName() {
+        return 'Security';
+    }
+    get archetype() {
+        return 'custom';
+    }
+    get behavior() {
+        return { role: 'security', activity: 'idle', idlePose: 'stand' };
+    }
+    async collect() {
+        return { status: 'healthy', mood: 'happy', message: '', metrics: {} };
+    }
+}
+exports.SecurityNPC = SecurityNPC;
+//# sourceMappingURL=index.js.map

package/dist/cli.js

@@ -47,7 +47,15 @@ Monitoring NPC types:
   internet-connectivity   Monitor network connectivity
   process-watcher         Watch for running processes
   log-watcher             Watch log files for errors
-  receptionist            Greeter showing time + local weather
+  receptionist            Lobby greeter with office check-ins and jokes
+  security                Indoor/outdoor patrols and exterior door watch
+  janitor                 Mops suspicious spots and hunts office bugs
+  barista                 Takes increasingly absurd coffee orders
+  office-cat              Naps on desks and supervises keyboards
+  office-dog              Naps, barks at coworkers and runs around
+  plant-caretaker         Waters plants and reviews their performance
+  it-technician           Inspects tech gear and recommends reboots
+  out-of-touch-executive  Interrupts coworkers between long lounge breaks
   github-watcher          Call out new commits on a repo
   web-page-watcher        Render a watched web page as a pixel-art TV
 
@@ -102,13 +110,8 @@ Log Watcher Options:
   --error-crit=<n>        Error count for critical status (default: 20)
   --report-interval=<ms>  Report interval in ms (default: 15000)
 
-Receptionist Options:
-  --poll-interval=<ms>    Clock tick in ms (default: 60000)
-  --lat=<n> --lon=<n>     Explicit coordinates for weather
-  --location=<name>       Place name to geocode (open-meteo)
-  --no-ip-geo             Without --lat/--lon or --location, don't look up
-                          this machine's IP location (ipapi.co); show time only
-  --fahrenheit            Show temperature in °F (default: °C)
+Office Character Options:
+  --poll-interval=<ms>    Heartbeat interval in ms (default: 60000)
 
 GitHub Watcher Options:
   --repo=<owner/name>     Repository to watch (required)
@@ -361,6 +364,37 @@ async function main() {
             await npc.start();
             break;
         }
+        case 'security': {
+            if (!config.serviceId)
+                config.serviceId = 'security';
+            const { SecurityNPC } = await import('./npcs/security/index.js');
+            const npc = new SecurityNPC({
+                ...config,
+                pollInterval: numberFlag(parsed.flags, 'poll-interval'),
+            });
+            logger.info('Starting security NPC');
+            await npc.start();
+            break;
+        }
+        case 'janitor':
+        case 'barista':
+        case 'office-cat':
+        case 'office-dog':
+        case 'plant-caretaker':
+        case 'it-technician':
+        case 'out-of-touch-executive': {
+            if (!config.serviceId)
+                config.serviceId = parsed.command;
+            const { OFFICE_CHARACTER_NPCS } = await import('./npcs/office-characters/index.js');
+            const NPCClass = OFFICE_CHARACTER_NPCS[parsed.command];
+            const npc = new NPCClass({
+                ...config,
+                pollInterval: numberFlag(parsed.flags, 'poll-interval'),
+            });
+            logger.info(`Starting ${parsed.command} NPC`);
+            await npc.start();
+            break;
+        }
         case 'github-watcher': {
             const repo = stringFlag(parsed.flags, 'repo');
             if (!repo) {

package/dist/core/base-npc.js

@@ -128,6 +128,13 @@ export class BaseNPC {
             alertConfig: { heartbeatInterval: this.heartbeatSeconds },
             map: this.config.map,
         });
+        // An observer cannot interrupt monitoring or retries.
+        try {
+            this.config.onPushResult?.({ success: result.success, error: result.error });
+        }
+        catch {
+            /* observer only */
+        }
         if (!result.success) {
             this.reportPushFailure(result.error);
         }

package/dist/core/types.d.ts

@@ -14,6 +14,11 @@ export interface NpcConfig {
     map?: string;
     /** Friendly display name for the NPC banner. Overrides the per-NPC default. */
     name?: string;
+    /** Optional local observer for publishing health; never included in status payloads. */
+    onPushResult?: (result: {
+        success: boolean;
+        error?: string;
+    }) => void;
 }
 export interface CollectedMetrics {
     status: Status;

package/dist/index.d.ts

@@ -41,4 +41,6 @@ export type { GeminiSetupOptions } from './npcs/gemini/index.js';
 export { CURSOR_DEFAULTS, CURSOR_ADAPTER, cursorServiceId, handleCursorHookEvent, setupCursorHooks, uninstallCursorHooks, installCursorHooksInto, CURSOR_HOOK_EVENTS, } from './npcs/cursor/index.js';
 export type { CursorSetupOptions } from './npcs/cursor/index.js';
 export { isCursorInvocation, normalizeCursorEvent } from './npcs/cursor/normalize.js';
+export { SecurityNPC } from './npcs/security/index.js';
+export { JanitorNPC, BaristaNPC, OfficeCatNPC, OfficeDogNPC, PlantCaretakerNPC, ITTechnicianNPC, OutOfTouchExecutiveNPC, OFFICE_CHARACTER_NPCS, } from './npcs/office-characters/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -25,4 +25,6 @@ export { WebPageWatcherNPC } from './npcs/web-page-watcher/index.js';
 export { GEMINI_DEFAULTS, GEMINI_ADAPTER, geminiTransition, geminiServiceId, handleGeminiHookEvent, setupGeminiHooks, uninstallGeminiHooks, installGeminiHooksInto, GEMINI_HOOK_EVENTS, } from './npcs/gemini/index.js';
 export { CURSOR_DEFAULTS, CURSOR_ADAPTER, cursorServiceId, handleCursorHookEvent, setupCursorHooks, uninstallCursorHooks, installCursorHooksInto, CURSOR_HOOK_EVENTS, } from './npcs/cursor/index.js';
 export { isCursorInvocation, normalizeCursorEvent } from './npcs/cursor/normalize.js';
+export { SecurityNPC } from './npcs/security/index.js';
+export { JanitorNPC, BaristaNPC, OfficeCatNPC, OfficeDogNPC, PlantCaretakerNPC, ITTechnicianNPC, OutOfTouchExecutiveNPC, OFFICE_CHARACTER_NPCS, } from './npcs/office-characters/index.js';
 //# sourceMappingURL=index.js.map

package/dist/npcs/agent-common/shim.js

@@ -77,13 +77,19 @@ try {
 if (neutral) process.stdout.write('{}\\n');
 `;
 export function installHookShim(nodePath, cliPath) {
+    // Desktop ships this same CLI with Electron's Node runtime. Keep the flag in
+    // the launcher (never globally), inherited by flush/watchdog child processes.
+    const electron = !!process.versions['electron'];
     writeChanged(RUNTIME_POINTER(), JSON.stringify({ node: nodePath, cli: cliPath }, null, 2) + '\n', 0o600);
     writeChanged(join(dirname(RUNTIME_POINTER()), 'node-path'), nodePath + '\n', 0o600);
     writeChanged(join(dirname(SHIM_PATH()), 'launch.cjs'), LAUNCHER, 0o600);
-    writeChanged(SHIM_PATH(), SHIM, 0o755);
+    writeChanged(SHIM_PATH(), electron ? SHIM.replace('exec "$NODE"', 'export ELECTRON_RUN_AS_NODE=1\nexec "$NODE"') : SHIM, 0o755);
     chmodSync(SHIM_PATH(), 0o755);
     // Both launchers use the same bootstrap, including imported-Cursor detection.
-    writeChanged(SHIM_PATH() + '.cmd', WINDOWS_SHIM.replace(/\n/g, '\r\n'), 0o755);
+    const windowsShim = electron
+        ? WINDOWS_SHIM.replace(':launch\n', ':launch\nset "ELECTRON_RUN_AS_NODE=1"\n')
+        : WINDOWS_SHIM;
+    writeChanged(SHIM_PATH() + '.cmd', windowsShim.replace(/\n/g, '\r\n'), 0o755);
     pruneOldRuntimes(dirname(RUNTIME_POINTER()));
     return SHIM_PATH();
 }

package/dist/npcs/office-characters/index.d.ts

@@ -0,0 +1,50 @@
+import { PollingNPC } from '../../core/polling-npc.js';
+import type { PollingNpcConfig } from '../../core/polling-npc.js';
+import type { Archetype, BehaviorHints, CollectedMetrics } from '../../core/types.js';
+/** Quiet heartbeats; the authoritative server drives routines and conversation. */
+declare abstract class OfficeCharacterNPC extends PollingNPC {
+    constructor(config: PollingNpcConfig);
+    abstract get name(): NonNullable<BehaviorHints['role']>;
+    get archetype(): Archetype;
+    get behavior(): BehaviorHints;
+    protected collect(): Promise<CollectedMetrics>;
+}
+export declare class JanitorNPC extends OfficeCharacterNPC {
+    get name(): 'janitor';
+    protected get defaultDisplayName(): string;
+}
+export declare class BaristaNPC extends OfficeCharacterNPC {
+    get name(): 'barista';
+    protected get defaultDisplayName(): string;
+}
+export declare class OfficeCatNPC extends OfficeCharacterNPC {
+    get name(): 'office-cat';
+    protected get defaultDisplayName(): string;
+}
+export declare class OfficeDogNPC extends OfficeCharacterNPC {
+    get name(): 'office-dog';
+    protected get defaultDisplayName(): string;
+}
+export declare class PlantCaretakerNPC extends OfficeCharacterNPC {
+    get name(): 'plant-caretaker';
+    protected get defaultDisplayName(): string;
+}
+export declare class ITTechnicianNPC extends OfficeCharacterNPC {
+    get name(): 'it-technician';
+    protected get defaultDisplayName(): string;
+}
+export declare class OutOfTouchExecutiveNPC extends OfficeCharacterNPC {
+    get name(): 'out-of-touch-executive';
+    protected get defaultDisplayName(): string;
+}
+export declare const OFFICE_CHARACTER_NPCS: {
+    readonly janitor: typeof JanitorNPC;
+    readonly barista: typeof BaristaNPC;
+    readonly 'office-cat': typeof OfficeCatNPC;
+    readonly 'office-dog': typeof OfficeDogNPC;
+    readonly 'plant-caretaker': typeof PlantCaretakerNPC;
+    readonly 'it-technician': typeof ITTechnicianNPC;
+    readonly 'out-of-touch-executive': typeof OutOfTouchExecutiveNPC;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/npcs/office-characters/index.js

@@ -0,0 +1,82 @@
+import { PollingNPC } from '../../core/polling-npc.js';
+/** Quiet heartbeats; the authoritative server drives routines and conversation. */
+class OfficeCharacterNPC extends PollingNPC {
+    constructor(config) {
+        super({ ...config, pollInterval: config.pollInterval ?? 60_000 });
+    }
+    get archetype() {
+        return 'custom';
+    }
+    get behavior() {
+        return { role: this.name, activity: 'idle', idlePose: 'stand' };
+    }
+    async collect() {
+        return { status: 'healthy', mood: 'happy', message: '', metrics: {} };
+    }
+}
+export class JanitorNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'janitor';
+    }
+    get defaultDisplayName() {
+        return 'Janitor';
+    }
+}
+export class BaristaNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'barista';
+    }
+    get defaultDisplayName() {
+        return 'Barista';
+    }
+}
+export class OfficeCatNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'office-cat';
+    }
+    get defaultDisplayName() {
+        return 'Office Cat';
+    }
+}
+export class OfficeDogNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'office-dog';
+    }
+    get defaultDisplayName() {
+        return 'Office Dog';
+    }
+}
+export class PlantCaretakerNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'plant-caretaker';
+    }
+    get defaultDisplayName() {
+        return 'Plant Caretaker';
+    }
+}
+export class ITTechnicianNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'it-technician';
+    }
+    get defaultDisplayName() {
+        return 'IT Technician';
+    }
+}
+export class OutOfTouchExecutiveNPC extends OfficeCharacterNPC {
+    get name() {
+        return 'out-of-touch-executive';
+    }
+    get defaultDisplayName() {
+        return 'Out-of-Touch Executive';
+    }
+}
+export const OFFICE_CHARACTER_NPCS = {
+    janitor: JanitorNPC,
+    barista: BaristaNPC,
+    'office-cat': OfficeCatNPC,
+    'office-dog': OfficeDogNPC,
+    'plant-caretaker': PlantCaretakerNPC,
+    'it-technician': ITTechnicianNPC,
+    'out-of-touch-executive': OutOfTouchExecutiveNPC,
+};
+//# sourceMappingURL=index.js.map

package/dist/npcs/process-watcher/index.js

@@ -1,7 +1,7 @@
 import { PollingNPC } from '../../core/polling-npc.js';
 import { evaluateThreshold, worstStatus, moodForStatus } from '../../core/thresholds.js';
 import { statusColor, pushHistory } from '../../core/screen.js';
-import { NpcConfigError, assertPosix } from '../../core/errors.js';
+import { NpcConfigError } from '../../core/errors.js';
 import { scanProcesses, detectTransitions } from './process-scanner.js';
 import { DEFAULTS } from './defaults.js';
 /** Max per-process panels on the companion dashboard. */
@@ -13,7 +13,6 @@ export class ProcessWatcherNPC extends PollingNPC {
     cpuHistories = new Map();
     previousRunning = null;
     constructor(config) {
-        assertPosix('process-watcher', 'It relies on the POSIX `ps` command; run it under WSL/Linux, or use system-monitor instead.');
         super(config);
         this.processes = [...new Set(config.processes.map((p) => p.trim()).filter(Boolean))];
         if (this.processes.length === 0) {

package/dist/npcs/process-watcher/process-scanner.d.ts

@@ -37,11 +37,13 @@ export declare function parsePsOutput(stdout: string): PsEntry[];
 export declare function matchesName(comm: string, searchName: string): boolean;
 /** List every process. Throws if `ps` fails — callers must not read that as "all dead". */
 export declare function listProcesses(): Promise<PsEntry[]>;
+/** Windows instance suffixes (#1, #2) distinguish copies of the same executable. */
+export declare function parseWindowsProcesses(stdout: string, cores?: number): PsEntry[];
 /** Summarise each watched name against a process list (CPU and memory summed per name). */
 export declare function matchProcesses(names: string[], entries: PsEntry[]): ProcessInfo[];
 /**
  * Scan for processes by name and return their status and resource usage.
- * Works on macOS and Linux via `ps`. Throws when the process list is unavailable.
+ * Uses `ps` on macOS/Linux and CIM on Windows. Throws when the process list is unavailable.
  */
 export declare function scanProcesses(names: string[]): Promise<ProcessInfo[]>;
 //# sourceMappingURL=process-scanner.d.ts.map

package/dist/npcs/process-watcher/process-scanner.js

@@ -1,5 +1,7 @@
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
+import { cpus } from 'node:os';
+import { join } from 'node:path';
 const execFileAsync = promisify(execFile);
 /** Bounds on the `ps` call: a wedged or enormous process table can't stall or flood us. */
 const PS_TIMEOUT_MS = 5000;
@@ -52,10 +54,10 @@ export function parsePsOutput(stdout) {
  * Unlike a substring match, `sh` does not match `bash` or `ssh-agent`.
  */
 export function matchesName(comm, searchName) {
-    if (searchName.includes('/'))
+    if (/[\\/]/.test(searchName))
         return comm === searchName;
-    const base = (comm.split('/').pop() ?? comm).toLowerCase();
-    const name = searchName.toLowerCase();
+    const base = (comm.split(/[\\/]/).pop() ?? comm).toLowerCase().replace(/\.exe$/, '');
+    const name = searchName.toLowerCase().replace(/\.exe$/, '');
     if (base === name)
         return true;
     if (name.length > LINUX_COMM_LEN && base === name.slice(0, LINUX_COMM_LEN))
@@ -64,6 +66,18 @@ export function matchesName(comm, searchName) {
 }
 /** List every process. Throws if `ps` fails — callers must not read that as "all dead". */
 export async function listProcesses() {
+    if (process.platform === 'win32') {
+        // Fixed command, no user strings interpolated. Performance counters report a
+        // sampling interval (Get-Process.CPU is lifetime CPU seconds, not a percent).
+        const executable = join(process.env['SystemRoot'] || 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+        const { stdout } = await execFileAsync(executable, [
+            '-NoProfile',
+            '-NonInteractive',
+            '-Command',
+            '$ErrorActionPreference="Stop"; Get-CimInstance Win32_PerfFormattedData_PerfProc_Process | Select-Object IDProcess,Name,PercentProcessorTime,WorkingSetPrivate | ConvertTo-Json -Compress',
+        ], { timeout: PS_TIMEOUT_MS, maxBuffer: PS_MAX_BUFFER, windowsHide: true });
+        return parseWindowsProcesses(stdout, cpus().length);
+    }
     const { stdout } = await execFileAsync('ps', ['-eo', 'pid=,pcpu=,rss=,comm='], {
         timeout: PS_TIMEOUT_MS,
         maxBuffer: PS_MAX_BUFFER,
@@ -72,6 +86,29 @@ export async function listProcesses() {
     });
     return parsePsOutput(stdout);
 }
+/** Windows instance suffixes (#1, #2) distinguish copies of the same executable. */
+export function parseWindowsProcesses(stdout, cores = 1) {
+    const value = JSON.parse(stdout.replace(/^\uFEFF/, ''));
+    const rows = Array.isArray(value) ? value : value ? [value] : [];
+    return rows.flatMap((row) => {
+        const pid = Number(row.IDProcess);
+        const cpu = Number(row.PercentProcessorTime);
+        const bytes = Number(row.WorkingSetPrivate);
+        if (!(pid > 0) ||
+            !Number.isFinite(cpu) ||
+            !Number.isFinite(bytes) ||
+            typeof row.Name !== 'string')
+            return [];
+        return [
+            {
+                pid,
+                cpu: cpu / Math.max(1, cores),
+                memKb: bytes / 1024,
+                comm: row.Name.replace(/#\d+$/, ''),
+            },
+        ];
+    });
+}
 /** Summarise each watched name against a process list (CPU and memory summed per name). */
 export function matchProcesses(names, entries) {
     return names.map((name) => {
@@ -92,7 +129,7 @@ export function matchProcesses(names, entries) {
 }
 /**
  * Scan for processes by name and return their status and resource usage.
- * Works on macOS and Linux via `ps`. Throws when the process list is unavailable.
+ * Uses `ps` on macOS/Linux and CIM on Windows. Throws when the process list is unavailable.
  */
 export async function scanProcesses(names) {
     return matchProcesses(names, await listProcesses());

package/dist/npcs/receptionist/index.d.ts

@@ -1,39 +1,20 @@
 import { PollingNPC } from '../../core/polling-npc.js';
 import type { PollingNpcConfig } from '../../core/polling-npc.js';
-import type { CollectedMetrics, Archetype, BehaviorHints, CompanionDecl } from '../../core/types.js';
+import type { CollectedMetrics, Archetype, BehaviorHints } from '../../core/types.js';
 export interface ReceptionistConfig extends PollingNpcConfig {
+    /** @deprecated Reception no longer uses weather or geolocation. Accepted for compatibility. */
     lat?: number;
     lon?: number;
     location?: string;
-    /** Display temperature in Fahrenheit instead of Celsius. */
     fahrenheit?: boolean;
-    /**
-     * Fall back to IP geolocation (ipapi.co) when no --lat/--lon or --location
-     * is given. Default true; false keeps the receptionist in time-only mode
-     * rather than sending this machine's IP to a third party.
-     */
     ipGeo?: boolean;
 }
 export declare class ReceptionistNPC extends PollingNPC {
-    private explicitCoords;
-    private location?;
-    private fahrenheit;
-    private ipGeo;
-    private coords;
-    /** Earliest time to retry geocoding / IP geo after a failure. */
-    private nextGeoAttempt;
-    private weather;
-    private weatherFetchedAt;
-    /** Earliest time to retry the weather after a failure. */
-    private nextWeatherAttempt;
     constructor(config: ReceptionistConfig);
     get name(): string;
     protected get defaultDisplayName(): string;
     get archetype(): Archetype;
     get behavior(): BehaviorHints;
-    get companion(): CompanionDecl;
     protected collect(): Promise<CollectedMetrics>;
-    private refreshWeather;
-    private resolveCoords;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/npcs/receptionist/index.js

@@ -1,34 +1,7 @@
 import { PollingNPC } from '../../core/polling-npc.js';
-import { NpcConfigError } from '../../core/errors.js';
-import { DEFAULTS } from './defaults.js';
-import { fetchWeather, geocodeLocation, autoGeo, formatClock, toFahrenheit, validCoords, } from './weather.js';
 export class ReceptionistNPC extends PollingNPC {
-    explicitCoords;
-    location;
-    fahrenheit;
-    ipGeo;
-    coords = null;
-    /** Earliest time to retry geocoding / IP geo after a failure. */
-    nextGeoAttempt = 0;
-    weather = null;
-    weatherFetchedAt = 0;
-    /** Earliest time to retry the weather after a failure. */
-    nextWeatherAttempt = 0;
     constructor(config) {
-        super({ ...config, pollInterval: config.pollInterval ?? DEFAULTS.pollInterval });
-        if ((config.lat === undefined) !== (config.lon === undefined)) {
-            throw new NpcConfigError('--lat and --lon must be given together');
-        }
-        if (config.lat !== undefined && !validCoords(config.lat, config.lon)) {
-            throw new NpcConfigError('--lat must be within ±90 and --lon within ±180');
-        }
-        this.explicitCoords =
-            config.lat !== undefined && config.lon !== undefined
-                ? { lat: config.lat, lon: config.lon }
-                : null;
-        this.location = config.location?.trim() || undefined;
-        this.fahrenheit = config.fahrenheit ?? false;
-        this.ipGeo = config.ipGeo ?? true;
+        super({ ...config, pollInterval: config.pollInterval ?? 60_000 });
     }
     get name() {
         return 'receptionist';
@@ -41,102 +14,16 @@ export class ReceptionistNPC extends PollingNPC {
     }
     get behavior() {
         return {
+            role: 'receptionist',
+            activity: 'idle',
             greetPlayers: true,
-            patrol: { everyMinutes: [15, 30], stops: 5 },
             idle: 'stay',
-            home: { near: 'entrance' },
-        };
-    }
-    get companion() {
-        return {
-            screenType: 'welcome-sign',
-            size: { w: 2, h: 1 },
-            placement: 'adjacent-wall',
-            label: 'Welcome',
+            idlePose: 'sit',
         };
     }
     async collect() {
-        await this.refreshWeather();
-        const now = new Date();
-        const { day, date, time } = formatClock(now);
-        const values = [
-            { label: 'time', value: time },
-            { label: 'day', value: day },
-            { label: 'date', value: date },
-        ];
-        let message = `${day} ${time}`;
-        const metrics = { weather_ok: this.weather ? 1 : 0 };
-        if (this.weather) {
-            const temp = this.fahrenheit
-                ? `${toFahrenheit(this.weather.tempC)}°F`
-                : `${this.weather.tempC}°C`;
-            message += ` • ${temp} ${this.weather.text}`;
-            values.push({ label: 'temp', value: temp }, { label: 'condition', value: this.weather.text }, { label: 'icon', value: this.weather.icon });
-            metrics['temp_c'] = this.weather.tempC;
-            metrics['weather_code'] = this.weather.code;
-            metrics['wind_kph'] = this.weather.windKph;
-        }
-        // The receptionist is a greeter/clock — it stays healthy even when weather
-        // is unavailable (degraded time-only mode).
-        return {
-            status: 'healthy',
-            mood: 'happy',
-            message,
-            screenData: { layout: 'welcome-sign', values },
-            metrics,
-        };
-    }
-    async refreshWeather() {
-        const now = Date.now();
-        if (!this.coords)
-            await this.resolveCoords(now);
-        // Don't show a reading that has gone stale through repeated failures.
-        if (this.weather && now - this.weatherFetchedAt > DEFAULTS.weatherMaxAgeMs) {
-            this.weather = null;
-        }
-        if (!this.coords || now < this.nextWeatherAttempt)
-            return;
-        if (this.weather && now - this.weatherFetchedAt < DEFAULTS.weatherRefreshMs)
-            return;
-        const w = await fetchWeather(this.coords, DEFAULTS.fetchTimeoutMs);
-        if (w) {
-            this.weather = w;
-            this.weatherFetchedAt = now;
-        }
-        else {
-            this.nextWeatherAttempt = now + DEFAULTS.retryBackoffMs;
-        }
-    }
-    async resolveCoords(now) {
-        if (this.explicitCoords) {
-            this.coords = this.explicitCoords;
-            return;
-        }
-        // Back off after a failure rather than hitting the keyless endpoints every tick.
-        if (now < this.nextGeoAttempt)
-            return;
-        this.nextGeoAttempt = now + DEFAULTS.retryBackoffMs;
-        if (this.location) {
-            this.coords = await geocodeLocation(this.location, DEFAULTS.fetchTimeoutMs);
-            if (this.coords)
-                return;
-            this.logger.warn(`Could not geocode "${this.location}"` + (this.ipGeo ? ', falling back to IP geo' : ''));
-        }
-        if (!this.ipGeo) {
-            if (!this.location) {
-                this.nextGeoAttempt = Infinity; // nothing to resolve, ever
-                this.logger.info('No location set and IP geolocation disabled: time-only mode');
-            }
-            return;
-        }
-        this.coords = await autoGeo(DEFAULTS.fetchTimeoutMs);
-        if (this.coords) {
-            this.logger.info("Weather location estimated from this machine's IP via ipapi.co " +
-                '(set --location or --lat/--lon, or pass --no-ip-geo to disable)');
-        }
-        else {
-            this.logger.warn('Weather geo unavailable — running in time-only mode for now');
-        }
+        // The server handles conversation and movement. Heartbeats stay quiet.
+        return { status: 'healthy', mood: 'happy', message: '', metrics: {} };
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/npcs/security/index.d.ts

@@ -0,0 +1,12 @@
+import { PollingNPC } from '../../core/polling-npc.js';
+import type { PollingNpcConfig } from '../../core/polling-npc.js';
+import type { CollectedMetrics, Archetype, BehaviorHints } from '../../core/types.js';
+export declare class SecurityNPC extends PollingNPC {
+    constructor(config: PollingNpcConfig);
+    get name(): string;
+    protected get defaultDisplayName(): string;
+    get archetype(): Archetype;
+    get behavior(): BehaviorHints;
+    protected collect(): Promise<CollectedMetrics>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/npcs/security/index.js

@@ -0,0 +1,22 @@
+import { PollingNPC } from '../../core/polling-npc.js';
+export class SecurityNPC extends PollingNPC {
+    constructor(config) {
+        super({ ...config, pollInterval: config.pollInterval ?? 60_000 });
+    }
+    get name() {
+        return 'security';
+    }
+    get defaultDisplayName() {
+        return 'Security';
+    }
+    get archetype() {
+        return 'custom';
+    }
+    get behavior() {
+        return { role: 'security', activity: 'idle', idlePose: 'stand' };
+    }
+    async collect() {
+        return { status: 'healthy', mood: 'happy', message: '', metrics: {} };
+    }
+}
+//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nocville/npc",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Put your Claude Code and Codex sessions (and your servers) in the Nocville office as live NPCs",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,7 +24,7 @@
   ],
   "dependencies": {
     "pngjs": "^7.0.0",
-    "@nocville/node": "^0.2.3"
+    "@nocville/node": "^0.3.0"
   },
   "peerDependencies": {
     "puppeteer-core": "*"