@openclawcity/openclawcity 1.0.15 → 1.0.17

package/dist/context-dedup.d.ts

@@ -0,0 +1,25 @@
+/**
+ * City-context injection de-duplication.
+ *
+ * The channel prepends a [CITY CONTEXT] heartbeat snapshot to each inbound event
+ * so the model knows where it is. That snapshot is cached (~5 min), so within a
+ * burst of events every prepend is byte-for-byte identical — re-injecting it adds
+ * no information, only token bloat and a wall of repeated context in the agent's
+ * history (the Aaga model-login loop, 2026-06-30, prepended it ~7× in a minute).
+ *
+ * This gates the prepend: inject only when it's the first event for a key, the
+ * window has elapsed, or the snapshot actually changed (cache refresh). Keyed per
+ * (account, peer) so two concurrent conversations each still receive context — only
+ * redundant repeats inside one conversation are suppressed. No information is lost:
+ * the suppressed copies are identical to the one already in the session history.
+ */
+export interface ContextInjectionRecord {
+    at: number;
+    ctx: string;
+}
+/**
+ * Decide whether to prepend the city-context snapshot for `key`, and record the
+ * decision in `state`. Returns true to inject (and updates the record), false to
+ * skip a recent identical repeat. Pure given (state, key, ctx, now, windowMs).
+ */
+export declare function shouldInjectCityContext(state: Map<string, ContextInjectionRecord>, key: string, ctx: string, now: number, windowMs: number): boolean;

package/dist/index.d.ts

@@ -3,7 +3,11 @@ export declare function sanitizeReplyText(text: string): string | null;
 declare const plugin: {
     id: string;
     name: string;
-    configSchema: Record<string, unknown>;
+    configSchema: {
+        type: "object";
+        properties: {};
+        additionalProperties: boolean;
+    };
     register(api: OpenClawPluginApi): void;
 };
 export default plugin;

package/dist/index.js

@@ -3646,9 +3646,6 @@ var require_websocket_server = __commonJS({
   }
 });
 
-// .tsc-out/index.js
-import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
-
 // .tsc-out/runtime.js
 var runtime = null;
 function setRuntime(next) {
@@ -4072,9 +4069,22 @@ var OpenClawCityAdapter = class {
 
 // .tsc-out/index.js
 import { exposeAccountEnv, clearAccountEnv } from "./env-bridge.js";
+
+// .tsc-out/context-dedup.js
+function shouldInjectCityContext(state, key, ctx, now, windowMs) {
+  const prev = state.get(key);
+  const inject = !prev || now - prev.at >= windowMs || prev.ctx !== ctx;
+  if (inject) {
+    state.set(key, { at: now, ctx });
+  }
+  return inject;
+}
+
+// .tsc-out/index.js
 var CHANNEL_ID = "openclawcity";
 var DEFAULT_API_BASE = "https://api.openbotcity.com";
 var HEARTBEAT_CACHE_MS = 5 * 60 * 1e3;
+var CONTEXT_REINJECT_WINDOW_MS = 60 * 1e3;
 function deriveApiBase(gatewayUrl) {
   if (!gatewayUrl)
     return DEFAULT_API_BASE;
@@ -4094,6 +4104,7 @@ function sanitizeReplyText(text) {
 }
 var adapters = /* @__PURE__ */ new Map();
 var heartbeatCache = /* @__PURE__ */ new Map();
+var contextInjectionState = /* @__PURE__ */ new Map();
 async function fetchHeartbeatContext(apiBase, jwt, accountId, log) {
   const cached = heartbeatCache.get(accountId);
   const now = Date.now();
@@ -4194,12 +4205,17 @@ var occPlugin = {
           const apiBase = deriveApiBase(account.gatewayUrl);
           const cityCtx = await fetchHeartbeatContext(apiBase, account.apiKey, accountId, log);
           if (cityCtx) {
-            envelope.content.text = `[CITY CONTEXT]
+            const dedupKey = `${accountId}:${envelope.sender.id}`;
+            if (shouldInjectCityContext(contextInjectionState, dedupKey, cityCtx, Date.now(), CONTEXT_REINJECT_WINDOW_MS)) {
+              envelope.content.text = `[CITY CONTEXT]
 ${cityCtx}
 [/CITY CONTEXT]
 
 ${envelope.content.text}`;
-            log?.info?.(`[OCC] City context prepended (${cityCtx.length} bytes)`);
+              log?.info?.(`[OCC] City context prepended (${cityCtx.length} bytes)`);
+            } else {
+              log?.info?.(`[OCC] City context skipped (recent + unchanged) for ${dedupKey}`);
+            }
           }
           log?.info?.(`[OCC] Step 1: resolveAgentRoute...`);
           let route;
@@ -4396,7 +4412,7 @@ ${envelope.content.text}`;
 var plugin = {
   id: CHANNEL_ID,
   name: "OpenClawCity Channel",
-  configSchema: emptyPluginConfigSchema(),
+  configSchema: { type: "object", properties: {}, additionalProperties: true },
   register(api) {
     setRuntime(api.runtime);
     api.registerChannel({ plugin: occPlugin });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclawcity/openclawcity",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "OpenClawCity channel plugin for OpenClaw — live city events for AI agents",
   "type": "module",
   "main": "./dist/index.js",