@nocville/npc 0.4.1 → 0.5.0

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

@@ -139,6 +139,15 @@ class BaseNPC {
         catch {
             /* observer only */
         }
+        if (!result.success && [401, 410].includes(result.statusCode ?? 0)) {
+            // A revoked key or an SDK version the server retired: retrying forever only
+            // costs requests. Stop; restarting after fixing it resumes monitoring.
+            this.logger.error(result.statusCode === 410
+                ? 'This @nocville/npc version is no longer supported — upgrade it. Stopping.'
+                : 'API key rejected (HTTP 401) — check NOCVILLE_API_KEY / team settings. Stopping.');
+            void this.stop();
+            return;
+        }
         if (!result.success) {
             this.reportPushFailure(result.error);
         }

package/dist/cjs/core/pixel-art.js

@@ -4,6 +4,7 @@ exports.encodePixelArt = encodePixelArt;
 exports.pixelArtFromPng = pixelArtFromPng;
 exports.pixelDevice = pixelDevice;
 const node_fs_1 = require("node:fs");
+const node_zlib_1 = require("node:zlib");
 const pngjs_1 = require("pngjs");
 /**
  * Helpers for custom pixel-art companions (`screenType: 'pixel-device'`): your NPC's own
@@ -68,7 +69,9 @@ function encodePixelArt(art) {
         const fps = Math.min(12, Math.max(1, Math.round(art.fps ?? 4)));
         tokens.push(`f${frames.length}`, `fps${fps}`);
     }
-    const encoded = pixels.toString('base64');
+    // Deflated indices (`z`) are typically 15–25× smaller for pixel art.
+    tokens.push('z');
+    const encoded = (0, node_zlib_1.deflateRawSync)(pixels, { level: 9 }).toString('base64');
     if (encoded.length > MAX_VALUE)
         throw new Error('Pixel art is too large to send; use fewer frames or a smaller size.');
     return {

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

@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PollingNPC = exports.MIN_POLL_INTERVAL_MS = void 0;
 const base_npc_js_1 = require("./base-npc.js");
 /**
- * Lower bound for any poll interval, so a typo can't exhaust the API's
- * per-service rate limit (60 pushes/min) or hammer the watched source.
+ * Lower bound for any poll interval, so a typo can't hammer the watched source.
+ * The SDK sends changed status at most every 10 s and heartbeats every 30 s;
+ * the server limits producers per key, team and NPC and answers 429.
  */
 exports.MIN_POLL_INTERVAL_MS = 5000;
 /** How long `stop()` waits for an in-flight collection before pushing offline anyway. */

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

@@ -261,17 +261,43 @@ function buildAgentPayload(adapter, state, config) {
         map: config.map,
     };
 }
+/**
+ * Clients reused within one process (a long-lived watchdog): a fresh client
+ * re-runs enrollment, manifest, version and session requests on every push.
+ * Any failure (e.g. a hook process took over the producer session) drops it.
+ */
+const clients = new Map();
 async function defaultPush(config, serviceId, payload, timeoutMs) {
-    const client = new node_1.NocvilleClient({
-        workspace: config.workspace,
-        apiUrl: config.apiUrl,
-        apiKey: config.apiKey,
+    const key = JSON.stringify([
+        config.workspace,
+        config.apiUrl,
+        config.apiKey,
         serviceId,
-        timeout: timeoutMs,
-        retries: 0,
-        debug: config.debug,
-    });
-    return client.pushStatus(payload);
+        timeoutMs,
+    ]);
+    let client = clients.get(key);
+    if (!client) {
+        client = new node_1.NocvilleClient({
+            workspace: config.workspace,
+            apiUrl: config.apiUrl,
+            apiKey: config.apiKey,
+            serviceId,
+            timeout: timeoutMs,
+            retries: 0,
+            debug: config.debug,
+        });
+        clients.set(key, client);
+    }
+    try {
+        const result = await client.pushStatus(payload);
+        if (!result.success)
+            clients.delete(key);
+        return result;
+    }
+    catch (error) {
+        clients.delete(key);
+        throw error;
+    }
 }
 /**
  * Push the session's current state if it has unpushed changes (or is offline),

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

@@ -7,7 +7,8 @@ const liveness_js_1 = require("./liveness.js");
 const lock_js_1 = require("./lock.js");
 const session_js_1 = require("./session.js");
 exports.WATCHDOG_TICK_MS = 15_000;
-exports.WATCHDOG_HEARTBEAT_MS = 60_000;
+/** Liveness only (status changes push at once); each heartbeat is a billed request. */
+exports.WATCHDOG_HEARTBEAT_MS = 300_000;
 exports.WATCHDOG_OFFLINE_RETRY_MS = 15 * 60_000;
 async function ensureWatchdog(adapter, config, sessionId, cliPath, lockWaitMs) {
     if (adapter.processNames?.length === 0 ||
@@ -42,7 +43,7 @@ async function runWatchdog(adapter, config, sessionId, deps = {}) {
     const delivery = {
         ...deps,
         onResult: (result) => {
-            if (!result.success && [400, 401, 403, 404].includes(result.statusCode ?? 0))
+            if (!result.success && [400, 401, 403, 404, 410].includes(result.statusCode ?? 0))
                 rejected = true;
             deps.onResult?.(result);
         },
@@ -123,7 +124,7 @@ async function runWatchdog(adapter, config, sessionId, deps = {}) {
                     ...deps,
                     force: true,
                     onResult: (result) => {
-                        if (!result.success && [400, 401, 403, 404].includes(result.statusCode ?? 0))
+                        if (!result.success && [400, 401, 403, 404, 410].includes(result.statusCode ?? 0))
                             heartbeatRejected = true;
                         deps.onResult?.(result);
                     },

package/dist/cjs/npcs/claude-code/defaults.js

@@ -8,8 +8,8 @@ exports.DEFAULTS = {
     stateFilePrefix: 'session-',
     stateFileMaxAge: 24 * 60 * 60 * 1000, // 24 hours
     httpTimeout: 4000,
-    /** Watchdog-backed sessions become unknown after three minutes without a heartbeat. */
-    heartbeatSeconds: 90,
+    /** Watchdog-backed sessions become unknown after twelve minutes without a heartbeat. */
+    heartbeatSeconds: 360,
     /** Number of recent activity lines kept in the desk-sign ticker. */
     activityBufferSize: 8,
     /** Coalesce same-phase activity pushes closer together than this. */

package/dist/cjs/npcs/codex/defaults.js

@@ -8,8 +8,8 @@ exports.CODEX_DEFAULTS = {
     /** Hook-mode per-session state (shared with the watcher to avoid double pushes). */
     stateDir: (0, node_path_1.join)((0, node_os_1.tmpdir)(), 'nocville-codex'),
     stateFileMaxAge: 24 * 60 * 60 * 1000,
-    /** Watchdog-backed sessions become unknown after three minutes without a heartbeat. */
-    heartbeatSeconds: 90,
+    /** Watchdog-backed sessions become unknown after twelve minutes without a heartbeat. */
+    heartbeatSeconds: 360,
     minPushGapMs: 1500,
     hookTimeoutSeconds: 10,
     /** Watcher: Codex session rollout logs. */

package/dist/cjs/npcs/cursor/defaults.js

@@ -6,7 +6,7 @@ const node_path_1 = require("node:path");
 exports.CURSOR_DEFAULTS = {
     stateDir: (0, node_path_1.join)((0, node_os_1.tmpdir)(), 'nocville-cursor'),
     stateFileMaxAge: 24 * 60 * 60 * 1000,
-    heartbeatSeconds: 90,
+    heartbeatSeconds: 360,
     minPushGapMs: 1500,
     hookTimeoutSeconds: 10,
 };

package/dist/cjs/npcs/cursor/hook-handler.js

@@ -15,7 +15,7 @@ exports.CURSOR_ADAPTER = {
     label: 'Cursor',
     family: 'cursor',
     stateDir: defaults_js_1.CURSOR_DEFAULTS.stateDir,
-    heartbeatSeconds: 90,
+    heartbeatSeconds: 360,
     processNames: [],
 };
 function cursorServiceId(sessionId, cwd) {

package/dist/cjs/npcs/gemini/defaults.js

@@ -6,7 +6,7 @@ const node_path_1 = require("node:path");
 exports.GEMINI_DEFAULTS = {
     stateDir: (0, node_path_1.join)((0, node_os_1.tmpdir)(), 'nocville-gemini'),
     stateFileMaxAge: 24 * 60 * 60 * 1000,
-    heartbeatSeconds: 90,
+    heartbeatSeconds: 360,
     minPushGapMs: 1500,
     hookTimeoutMs: 5000,
 };

package/dist/cjs/npcs/web-page-watcher/pixelate.js

@@ -7,6 +7,7 @@ exports.quantize = quantize;
 exports.buildPixelImageScreen = buildPixelImageScreen;
 exports.fnv1a = fnv1a;
 exports.pngToPixelImage = pngToPixelImage;
+const node_zlib_1 = require("node:zlib");
 const pngjs_1 = require("pngjs");
 /** Default target resolution for the web-view TV (4:3 to match a 4×3 companion). */
 exports.TARGET_W = 160;
@@ -143,9 +144,9 @@ function buildPixelImageScreen(width, height, palette, indices) {
     return {
         layout: 'pixel-image',
         values: [
-            { label: 'fmt', value: `idx8;${width}x${height};p${paletteCount}` },
+            { label: 'fmt', value: `idx8;${width}x${height};p${paletteCount};z` },
             { label: 'palette', value: Buffer.from(palette).toString('base64') },
-            { label: 'pixels', value: Buffer.from(indices).toString('base64') },
+            { label: 'pixels', value: (0, node_zlib_1.deflateRawSync)(indices, { level: 9 }).toString('base64') },
         ],
     };
 }

package/dist/core/base-npc.js

@@ -136,6 +136,15 @@ export class BaseNPC {
         catch {
             /* observer only */
         }
+        if (!result.success && [401, 410].includes(result.statusCode ?? 0)) {
+            // A revoked key or an SDK version the server retired: retrying forever only
+            // costs requests. Stop; restarting after fixing it resumes monitoring.
+            this.logger.error(result.statusCode === 410
+                ? 'This @nocville/npc version is no longer supported — upgrade it. Stopping.'
+                : 'API key rejected (HTTP 401) — check NOCVILLE_API_KEY / team settings. Stopping.');
+            void this.stop();
+            return;
+        }
         if (!result.success) {
             this.reportPushFailure(result.error);
         }

package/dist/core/pixel-art.js

@@ -1,4 +1,5 @@
 import { readFileSync } from 'node:fs';
+import { deflateRawSync } from 'node:zlib';
 import { PNG } from 'pngjs';
 /**
  * Helpers for custom pixel-art companions (`screenType: 'pixel-device'`): your NPC's own
@@ -63,7 +64,9 @@ export function encodePixelArt(art) {
         const fps = Math.min(12, Math.max(1, Math.round(art.fps ?? 4)));
         tokens.push(`f${frames.length}`, `fps${fps}`);
     }
-    const encoded = pixels.toString('base64');
+    // Deflated indices (`z`) are typically 15–25× smaller for pixel art.
+    tokens.push('z');
+    const encoded = deflateRawSync(pixels, { level: 9 }).toString('base64');
     if (encoded.length > MAX_VALUE)
         throw new Error('Pixel art is too large to send; use fewer frames or a smaller size.');
     return {

package/dist/core/polling-npc.d.ts

@@ -6,8 +6,9 @@ export interface PollingNpcConfig extends NpcConfig {
     onCollection?: (metrics: CollectedMetrics) => void;
 }
 /**
- * Lower bound for any poll interval, so a typo can't exhaust the API's
- * per-service rate limit (60 pushes/min) or hammer the watched source.
+ * Lower bound for any poll interval, so a typo can't hammer the watched source.
+ * The SDK sends changed status at most every 10 s and heartbeats every 30 s;
+ * the server limits producers per key, team and NPC and answers 429.
  */
 export declare const MIN_POLL_INTERVAL_MS = 5000;
 export declare abstract class PollingNPC extends BaseNPC {

package/dist/core/polling-npc.js

@@ -1,7 +1,8 @@
 import { BaseNPC } from './base-npc.js';
 /**
- * Lower bound for any poll interval, so a typo can't exhaust the API's
- * per-service rate limit (60 pushes/min) or hammer the watched source.
+ * Lower bound for any poll interval, so a typo can't hammer the watched source.
+ * The SDK sends changed status at most every 10 s and heartbeats every 30 s;
+ * the server limits producers per key, team and NPC and answers 429.
  */
 export const MIN_POLL_INTERVAL_MS = 5000;
 /** How long `stop()` waits for an in-flight collection before pushing offline anyway. */

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

@@ -239,17 +239,43 @@ export function buildAgentPayload(adapter, state, config) {
         map: config.map,
     };
 }
+/**
+ * Clients reused within one process (a long-lived watchdog): a fresh client
+ * re-runs enrollment, manifest, version and session requests on every push.
+ * Any failure (e.g. a hook process took over the producer session) drops it.
+ */
+const clients = new Map();
 async function defaultPush(config, serviceId, payload, timeoutMs) {
-    const client = new NocvilleClient({
-        workspace: config.workspace,
-        apiUrl: config.apiUrl,
-        apiKey: config.apiKey,
+    const key = JSON.stringify([
+        config.workspace,
+        config.apiUrl,
+        config.apiKey,
         serviceId,
-        timeout: timeoutMs,
-        retries: 0,
-        debug: config.debug,
-    });
-    return client.pushStatus(payload);
+        timeoutMs,
+    ]);
+    let client = clients.get(key);
+    if (!client) {
+        client = new NocvilleClient({
+            workspace: config.workspace,
+            apiUrl: config.apiUrl,
+            apiKey: config.apiKey,
+            serviceId,
+            timeout: timeoutMs,
+            retries: 0,
+            debug: config.debug,
+        });
+        clients.set(key, client);
+    }
+    try {
+        const result = await client.pushStatus(payload);
+        if (!result.success)
+            clients.delete(key);
+        return result;
+    }
+    catch (error) {
+        clients.delete(key);
+        throw error;
+    }
 }
 /**
  * Push the session's current state if it has unpushed changes (or is offline),

package/dist/npcs/agent-common/watchdog.d.ts

@@ -2,7 +2,8 @@ import type { NpcConfig } from '../../core/types.js';
 import { isAgentAlive } from './liveness.js';
 import type { AgentAdapter, PushDeps } from './session.js';
 export declare const WATCHDOG_TICK_MS = 15000;
-export declare const WATCHDOG_HEARTBEAT_MS = 60000;
+/** Liveness only (status changes push at once); each heartbeat is a billed request. */
+export declare const WATCHDOG_HEARTBEAT_MS = 300000;
 export declare const WATCHDOG_OFFLINE_RETRY_MS: number;
 export declare function ensureWatchdog(adapter: AgentAdapter, config: NpcConfig, sessionId: string, cliPath?: string, lockWaitMs?: number): Promise<void>;
 export interface WatchdogDeps extends PushDeps {

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

@@ -2,7 +2,8 @@ import { isAgentAlive } from './liveness.js';
 import { withStateLock } from './lock.js';
 import { flushSession, readSessionState, sleep, spawnDetachedAgent, stateFilePath, writeSessionState, } from './session.js';
 export const WATCHDOG_TICK_MS = 15_000;
-export const WATCHDOG_HEARTBEAT_MS = 60_000;
+/** Liveness only (status changes push at once); each heartbeat is a billed request. */
+export const WATCHDOG_HEARTBEAT_MS = 300_000;
 export const WATCHDOG_OFFLINE_RETRY_MS = 15 * 60_000;
 export async function ensureWatchdog(adapter, config, sessionId, cliPath, lockWaitMs) {
     if (adapter.processNames?.length === 0 ||
@@ -37,7 +38,7 @@ export async function runWatchdog(adapter, config, sessionId, deps = {}) {
     const delivery = {
         ...deps,
         onResult: (result) => {
-            if (!result.success && [400, 401, 403, 404].includes(result.statusCode ?? 0))
+            if (!result.success && [400, 401, 403, 404, 410].includes(result.statusCode ?? 0))
                 rejected = true;
             deps.onResult?.(result);
         },
@@ -118,7 +119,7 @@ export async function runWatchdog(adapter, config, sessionId, deps = {}) {
                     ...deps,
                     force: true,
                     onResult: (result) => {
-                        if (!result.success && [400, 401, 403, 404].includes(result.statusCode ?? 0))
+                        if (!result.success && [400, 401, 403, 404, 410].includes(result.statusCode ?? 0))
                             heartbeatRejected = true;
                         deps.onResult?.(result);
                     },

package/dist/npcs/claude-code/defaults.d.ts

@@ -3,7 +3,7 @@ export declare const DEFAULTS: {
     stateFilePrefix: string;
     stateFileMaxAge: number;
     httpTimeout: number;
-    /** Watchdog-backed sessions become unknown after three minutes without a heartbeat. */
+    /** Watchdog-backed sessions become unknown after twelve minutes without a heartbeat. */
     heartbeatSeconds: number;
     /** Number of recent activity lines kept in the desk-sign ticker. */
     activityBufferSize: number;

package/dist/npcs/claude-code/defaults.js

@@ -5,8 +5,8 @@ export const DEFAULTS = {
     stateFilePrefix: 'session-',
     stateFileMaxAge: 24 * 60 * 60 * 1000, // 24 hours
     httpTimeout: 4000,
-    /** Watchdog-backed sessions become unknown after three minutes without a heartbeat. */
-    heartbeatSeconds: 90,
+    /** Watchdog-backed sessions become unknown after twelve minutes without a heartbeat. */
+    heartbeatSeconds: 360,
     /** Number of recent activity lines kept in the desk-sign ticker. */
     activityBufferSize: 8,
     /** Coalesce same-phase activity pushes closer together than this. */

package/dist/npcs/codex/defaults.d.ts

@@ -2,7 +2,7 @@ export declare const CODEX_DEFAULTS: {
     /** Hook-mode per-session state (shared with the watcher to avoid double pushes). */
     stateDir: string;
     stateFileMaxAge: number;
-    /** Watchdog-backed sessions become unknown after three minutes without a heartbeat. */
+    /** Watchdog-backed sessions become unknown after twelve minutes without a heartbeat. */
     heartbeatSeconds: number;
     minPushGapMs: number;
     hookTimeoutSeconds: number;

package/dist/npcs/codex/defaults.js

@@ -4,8 +4,8 @@ export const CODEX_DEFAULTS = {
     /** Hook-mode per-session state (shared with the watcher to avoid double pushes). */
     stateDir: join(tmpdir(), 'nocville-codex'),
     stateFileMaxAge: 24 * 60 * 60 * 1000,
-    /** Watchdog-backed sessions become unknown after three minutes without a heartbeat. */
-    heartbeatSeconds: 90,
+    /** Watchdog-backed sessions become unknown after twelve minutes without a heartbeat. */
+    heartbeatSeconds: 360,
     minPushGapMs: 1500,
     hookTimeoutSeconds: 10,
     /** Watcher: Codex session rollout logs. */

package/dist/npcs/cursor/defaults.js

@@ -3,7 +3,7 @@ import { join } from 'node:path';
 export const CURSOR_DEFAULTS = {
     stateDir: join(tmpdir(), 'nocville-cursor'),
     stateFileMaxAge: 24 * 60 * 60 * 1000,
-    heartbeatSeconds: 90,
+    heartbeatSeconds: 360,
     minPushGapMs: 1500,
     hookTimeoutSeconds: 10,
 };

package/dist/npcs/cursor/hook-handler.js

@@ -10,7 +10,7 @@ export const CURSOR_ADAPTER = {
     label: 'Cursor',
     family: 'cursor',
     stateDir: CURSOR_DEFAULTS.stateDir,
-    heartbeatSeconds: 90,
+    heartbeatSeconds: 360,
     processNames: [],
 };
 export function cursorServiceId(sessionId, cwd) {

package/dist/npcs/gemini/defaults.js

@@ -3,7 +3,7 @@ import { join } from 'node:path';
 export const GEMINI_DEFAULTS = {
     stateDir: join(tmpdir(), 'nocville-gemini'),
     stateFileMaxAge: 24 * 60 * 60 * 1000,
-    heartbeatSeconds: 90,
+    heartbeatSeconds: 360,
     minPushGapMs: 1500,
     hookTimeoutMs: 5000,
 };

package/dist/npcs/web-page-watcher/pixelate.js

@@ -1,3 +1,4 @@
+import { deflateRawSync } from 'node:zlib';
 import { PNG } from 'pngjs';
 /** Default target resolution for the web-view TV (4:3 to match a 4×3 companion). */
 export const TARGET_W = 160;
@@ -134,9 +135,9 @@ export function buildPixelImageScreen(width, height, palette, indices) {
     return {
         layout: 'pixel-image',
         values: [
-            { label: 'fmt', value: `idx8;${width}x${height};p${paletteCount}` },
+            { label: 'fmt', value: `idx8;${width}x${height};p${paletteCount};z` },
             { label: 'palette', value: Buffer.from(palette).toString('base64') },
-            { label: 'pixels', value: Buffer.from(indices).toString('base64') },
+            { label: 'pixels', value: deflateRawSync(indices, { level: 9 }).toString('base64') },
         ],
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nocville/npc",
-  "version": "0.4.1",
+  "version": "0.5.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.4.1"
+    "@nocville/node": "^0.5.0"
   },
   "peerDependencies": {
     "puppeteer-core": "*"