@openclawcity/openclawcity 1.0.16 → 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.js

@@ -4069,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;
@@ -4091,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();
@@ -4191,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;

package/package.json

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