visionclaw 0.1.214-beta.0 → 0.1.214-beta.1

package/dist/agent/external-context/finapp-capability.d.ts

@@ -1,27 +1,10 @@
 /**
- * Refresh Fin-App external context (including fence capability catalog) from
- * the latest inbound messages. Used on wake start and again on interrupt so an
- * in-flight turn does not keep a stale client fence set.
+ * Fin-App-specific interpretation of client capability metadata.
+ * The external-context registry owns collection and interrupt refresh.
  */
-import type { VisionClawConfig } from "../../config/types.js";
 import type { CommandMessage } from "../../channels/interface.js";
-import type { SessionMode } from "../mailbox.js";
 /** True when any message carries Fin-App fence capability meta. */
 export declare function batchHasFinAppFenceCapability(messages: readonly CommandMessage[]): boolean;
-/**
- * Recollect Fin-App external context from `messages` and publish it as the
- * current wake's external context. No-op when the batch has no Fin-App fence
- * capability meta (keeps the prior wake catalog intact for non-finapp interrupts).
- */
-export declare function refreshFinAppExternalContextFromMessages(input: {
-    config: VisionClawConfig;
-    messages: readonly CommandMessage[];
-    sessionMode: SessionMode;
-    trigger?: "message" | "heartbeat";
-}): Promise<{
-    refreshed: boolean;
-    digest: string | null;
-}>;
 /**
  * Text blocks that force an in-flight model turn to see the new client fence
  * catalog even when the session system prompt was baked at wake start.

package/dist/agent/external-context/finapp-capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finapp-capability.d.ts","sourceRoot":"","sources":["../../../src/agent/external-context/finapp-capability.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD,mEAAmE;AACnE,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAQ1F;AAED;;;;GAIG;AACH,wBAAsB,wCAAwC,CAAC,KAAK,EAAE;IACpE,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;CACnC,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAYzD;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,GAAG,IAAI,CA4BhG"}
+{"version":3,"file":"finapp-capability.d.ts","sourceRoot":"","sources":["../../../src/agent/external-context/finapp-capability.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,mEAAmE;AACnE,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAQ1F;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,GAAG,IAAI,CA4BhG"}

package/dist/agent/external-context/finapp-capability.js

@@ -1,10 +1,7 @@
 /**
- * Refresh Fin-App external context (including fence capability catalog) from
- * the latest inbound messages. Used on wake start and again on interrupt so an
- * in-flight turn does not keep a stale client fence set.
+ * Fin-App-specific interpretation of client capability metadata.
+ * The external-context registry owns collection and interrupt refresh.
  */
-import { createDefaultExternalContextRegistry } from "./registry.js";
-import { setCurrentExternalContext } from "./runtime.js";
 /** True when any message carries Fin-App fence capability meta. */
 export function batchHasFinAppFenceCapability(messages) {
     return messages.some((msg) => {
@@ -16,24 +13,6 @@ export function batchHasFinAppFenceCapability(messages) {
             || (typeof restrict === "string" && restrict.trim().length > 0);
     });
 }
-/**
- * Recollect Fin-App external context from `messages` and publish it as the
- * current wake's external context. No-op when the batch has no Fin-App fence
- * capability meta (keeps the prior wake catalog intact for non-finapp interrupts).
- */
-export async function refreshFinAppExternalContextFromMessages(input) {
-    if (!batchHasFinAppFenceCapability(input.messages)) {
-        return { refreshed: false, digest: null };
-    }
-    const registry = createDefaultExternalContextRegistry(input.config);
-    const result = await registry.collect({
-        trigger: input.trigger ?? "message",
-        sessionMode: input.sessionMode,
-        messages: [...input.messages],
-    });
-    setCurrentExternalContext(result.section, result.digest);
-    return { refreshed: true, digest: result.digest };
-}
 /**
  * Text blocks that force an in-flight model turn to see the new client fence
  * catalog even when the session system prompt was baked at wake start.

package/dist/agent/external-context/finapp-capability.js.map

@@ -1 +1 @@
-{"version":3,"file":"finapp-capability.js","sourceRoot":"","sources":["../../../src/agent/external-context/finapp-capability.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"finapp-capability.js","sourceRoot":"","sources":["../../../src/agent/external-context/finapp-capability.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,mEAAmE;AACnE,MAAM,UAAU,6BAA6B,CAAC,QAAmC;IAC/E,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3B,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC;QAC7C,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,EAAE,qBAAqB,CAAC;QACjD,OAAO,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;eAC5D,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAmC;IAC/E,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ;YAAE,SAAS;QACvC,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,IAAI,EAAE,kBAAkB,KAAK,QAAQ;YAC9D,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE;YACpC,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,IAAI,EAAE,qBAAqB,KAAK,QAAQ;YAClE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE;YACvC,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ;YAAE,SAAS;QACpC,MAAM,KAAK,GAAG;YACZ,wHAAwH;SACzH,CAAC;QACF,IAAI,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,0EAA0E;YAC1E,sEAAsE;YACtE,qEAAqE;YACrE,KAAK,CAAC,IAAI,CACR,kHAAkH,CACnH,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/agent/external-context/interrupt.d.ts

@@ -0,0 +1,13 @@
+import type { CommandMessage } from "../../channels/interface.js";
+import type { SessionMode } from "../mailbox.js";
+import type { ExternalContextRegistry } from "./registry.js";
+/** Keep the existing wake context when no provider recognizes an interrupt update. */
+export declare function refreshExternalContextFromMessages(input: {
+    messages: readonly CommandMessage[];
+    sessionMode: SessionMode;
+    trigger?: "message" | "heartbeat";
+}, registry: ExternalContextRegistry): Promise<{
+    refreshed: boolean;
+    digest: string | null;
+}>;
+//# sourceMappingURL=interrupt.d.ts.map

package/dist/agent/external-context/interrupt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt.d.ts","sourceRoot":"","sources":["../../../src/agent/external-context/interrupt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAG7D,sFAAsF;AACtF,wBAAsB,kCAAkC,CAAC,KAAK,EAAE;IAC9D,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;CACnC,EAAE,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAW5F"}

package/dist/agent/external-context/interrupt.js

@@ -0,0 +1,16 @@
+import { getCurrentExternalContextProviderBlocks, setCurrentExternalContext } from "./runtime.js";
+/** Keep the existing wake context when no provider recognizes an interrupt update. */
+export async function refreshExternalContextFromMessages(input, registry) {
+    if (!registry.ownsInterrupt(input.messages))
+        return { refreshed: false, digest: null };
+    const result = await registry.collect({
+        trigger: input.trigger ?? "message",
+        sessionMode: input.sessionMode,
+        messages: [...input.messages],
+        interrupt: true,
+        previousProviderBlocks: getCurrentExternalContextProviderBlocks(),
+    });
+    setCurrentExternalContext(result.section, result.digest, result.providerBlocks);
+    return { refreshed: true, digest: result.digest };
+}
+//# sourceMappingURL=interrupt.js.map

package/dist/agent/external-context/interrupt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt.js","sourceRoot":"","sources":["../../../src/agent/external-context/interrupt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uCAAuC,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAElG,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,kCAAkC,CAAC,KAIxD,EAAE,QAAiC;IAClC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;QACpC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,SAAS;QACnC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC7B,SAAS,EAAE,IAAI;QACf,sBAAsB,EAAE,uCAAuC,EAAE;KAClE,CAAC,CAAC;IACH,yBAAyB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAChF,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AACpD,CAAC"}

package/dist/agent/external-context/providers/finapp.d.ts

@@ -1,10 +1,24 @@
+import { type CommandMessage } from "../../../channels/interface.js";
 import type { VisionClawConfig } from "../../../config/types.js";
-import type { ExternalContextBlock, ExternalContextProvider, ExternalContextProviderInput } from "../types.js";
+import type { ExternalContextBlock, ExternalContextProvider, ExternalContextProviderInput, ExternalConversationContext } from "../types.js";
 export declare class FinAppExternalContextProvider implements ExternalContextProvider {
     private readonly config;
     readonly source = "fin-app";
+    private credentialScope;
     private readonly cache;
     constructor(config: VisionClawConfig);
+    selectMessage(input: ExternalContextProviderInput): CommandMessage | undefined;
+    systemPrompt(conversation: ExternalConversationContext): string | null;
+    ownsInterrupt(messages: readonly CommandMessage[]): boolean;
+    canReuseContext(input: ExternalContextProviderInput, blocks: readonly ExternalContextBlock[]): boolean;
+    build(input: ExternalContextProviderInput): Promise<ExternalContextBlock[]>;
+}
+/** Local client capabilities have their own snapshot and cannot be lost to a remote fetch timeout. */
+export declare class FinAppClientContextProvider implements ExternalContextProvider {
+    readonly source = "fin-app-client";
+    selectMessage(input: ExternalContextProviderInput): CommandMessage | undefined;
+    ownsInterrupt(messages: readonly CommandMessage[]): boolean;
+    interruptText(messages: readonly CommandMessage[]): string | null;
     build(input: ExternalContextProviderInput): Promise<ExternalContextBlock[]>;
 }
 //# sourceMappingURL=finapp.d.ts.map

package/dist/agent/external-context/providers/finapp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finapp.d.ts","sourceRoot":"","sources":["../../../../src/agent/external-context/providers/finapp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAgB/G,qBAAa,6BAA8B,YAAW,uBAAuB;IAI/D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,QAAQ,CAAC,MAAM,aAAa;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyE;gBAElE,MAAM,EAAE,gBAAgB;IAE/C,KAAK,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;CA2FlF"}
+{"version":3,"file":"finapp.d.ts","sourceRoot":"","sources":["../../../../src/agent/external-context/providers/finapp.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAgB5I,qBAAa,6BAA8B,YAAW,uBAAuB;IAK/D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,QAAQ,CAAC,MAAM,aAAa;IAC5B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyE;gBAElE,MAAM,EAAE,gBAAgB;IAErD,aAAa,CAAC,KAAK,EAAE,4BAA4B,GAAG,cAAc,GAAG,SAAS;IAI9E,YAAY,CAAC,YAAY,EAAE,2BAA2B,GAAG,MAAM,GAAG,IAAI;IAMtE,aAAa,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO;IAI3D,eAAe,CAAC,KAAK,EAAE,4BAA4B,EAAE,MAAM,EAAE,SAAS,oBAAoB,EAAE,GAAG,OAAO;IAShG,KAAK,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;CAiElF;AAeD,sGAAsG;AACtG,qBAAa,2BAA4B,YAAW,uBAAuB;IACzE,QAAQ,CAAC,MAAM,oBAAoB;IAEnC,aAAa,CAAC,KAAK,EAAE,4BAA4B,GAAG,cAAc,GAAG,SAAS;IAI9E,aAAa,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO;IAI3D,aAAa,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,GAAG,IAAI;IAIjE,KAAK,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;CA4C5E"}

package/dist/agent/external-context/providers/finapp.js

@@ -1,64 +1,55 @@
 import crypto from "node:crypto";
+import { resolveThreadId } from "../../../channels/interface.js";
+import { isFinAppThreadId, isFinAppThreadMessage, loadFinAppCoreContract } from "../../fin-app/core-contract.js";
+import { batchHasFinAppFenceCapability, finAppCapabilityInterruptText } from "../finapp-capability.js";
 import { resolveFinAppCredentials } from "../../../finapp-credentials.js";
 const CONTEXT_CACHE_TTL_MS = 45_000;
 export class FinAppExternalContextProvider {
     config;
     source = "fin-app";
+    credentialScope = null;
     cache = new Map();
     constructor(config) {
         this.config = config;
     }
+    selectMessage(input) {
+        return selectFinAppMessage(input);
+    }
+    systemPrompt(conversation) {
+        if (!isFinAppThreadId(conversation.threadId) && !conversation.messages?.some(isFinAppThreadMessage))
+            return null;
+        return loadFinAppCoreContract()
+            ?? "## Fin-App Core Contract\n\nThe Fin-App core contract could not be loaded. Do not perform Fin-App writes or provide renderer-sensitive output until the contract is available.";
+    }
+    ownsInterrupt(messages) {
+        return batchHasFinAppFenceCapability(messages);
+    }
+    canReuseContext(input, blocks) {
+        const scope = credentialScope(resolveFinAppCredentials(this.config));
+        const message = selectFinAppMessage(input);
+        const threadId = message ? resolveThreadId(message) : undefined;
+        const key = threadId ? contextCacheKey(threadId, message?.meta ?? {}) : undefined;
+        return scope !== null && blocks.every((block) => block.metadata?.credentialScope === scope
+            && (!key || block.metadata.cacheKey === key));
+    }
     async build(input) {
         if (input.channel !== "finapp")
             return [];
-        const blocks = [];
-        const fenceCatalog = typeof input.channelMeta.fenceCatalogPrompt === "string"
-            ? input.channelMeta.fenceCatalogPrompt.trim()
-            : "";
-        if (fenceCatalog) {
-            blocks.push({
-                source: "fin-app-fence-catalog",
-                scope: "thread",
-                threadId: input.threadId,
-                title: "Fin-App fence catalog",
-                generatedAt: new Date().toISOString(),
-                digest: crypto.createHash("sha256").update(fenceCatalog).digest("hex").slice(0, 16),
-                // Above thread context and above the forbid appendix so schemas win.
-                priority: 115,
-                content: fenceCatalog,
-                metadata: {
-                    clientFences: input.channelMeta.clientFences,
-                },
-            });
-        }
-        const fencePrompt = typeof input.channelMeta.fenceCapabilityPrompt === "string"
-            ? input.channelMeta.fenceCapabilityPrompt.trim()
-            : "";
-        if (fencePrompt) {
-            blocks.push({
-                source: "fin-app-fences",
-                scope: "thread",
-                threadId: input.threadId,
-                title: "Fin-App client fences",
-                generatedAt: new Date().toISOString(),
-                digest: crypto.createHash("sha256").update(fencePrompt).digest("hex").slice(0, 16),
-                priority: 110,
-                content: fencePrompt,
-                metadata: {
-                    clientFences: input.channelMeta.clientFences,
-                },
-            });
-        }
         const credentials = resolveFinAppCredentials(this.config);
+        // A shared provider must never reuse data after credentials/service scope changes.
+        const scope = credentialScope(credentials);
+        if (scope !== this.credentialScope) {
+            this.cache.clear();
+            this.credentialScope = scope;
+        }
         if (!credentials)
-            return blocks;
+            return [];
         const userId = typeof input.channelMeta.userId === "number" ? input.channelMeta.userId : undefined;
-        const locale = input.channelMeta.locale === "zh" ? "zh" : input.channelMeta.locale === "en" ? "en" : "unknown";
         const messageKind = input.channelMeta.kind === "system" ? "system" : "user";
-        const cacheKey = `${userId ?? "unknown"}:${input.threadId}:${locale}:${messageKind}`;
+        const cacheKey = contextCacheKey(input.threadId, input.channelMeta);
         const cached = this.cache.get(cacheKey);
         if (cached && Date.now() - cached.fetchedAt < CONTEXT_CACHE_TTL_MS) {
-            return [...blocks, cached.block];
+            return [cached.block];
         }
         try {
             const response = await fetch(`${credentials.baseUrl}/api/internal/thread-context`, {
@@ -68,14 +59,18 @@ export class FinAppExternalContextProvider {
                     "Content-Type": "application/json",
                 },
                 body: JSON.stringify({ threadKey: input.threadId, ...(userId !== undefined ? { userId } : {}) }),
-                signal: AbortSignal.timeout(900),
+                signal: input.signal ? AbortSignal.any([input.signal, AbortSignal.timeout(900)]) : AbortSignal.timeout(900),
             });
+            if (credentialScope(resolveFinAppCredentials(this.config)) !== scope)
+                return [];
+            input.signal?.throwIfAborted();
             if (!response.ok) {
-                if (cached)
-                    return [...blocks, withDegradedReason(cached.block, `fin-app context endpoint HTTP ${response.status}`)];
-                return blocks;
+                throw new Error(`fin-app context endpoint HTTP ${response.status}`);
             }
             const context = await response.json();
+            if (credentialScope(resolveFinAppCredentials(this.config)) !== scope)
+                return [];
+            input.signal?.throwIfAborted();
             const block = {
                 source: "fin-app",
                 scope: "thread",
@@ -87,19 +82,101 @@ export class FinAppExternalContextProvider {
                 priority: 100,
                 content: renderFinAppContext(context, messageKind),
                 metadata: {
+                    credentialScope: scope,
+                    cacheKey,
                     threadKey: context.threadKey,
                     degradedReason: context.degradedReason,
                 },
             };
-            this.cache.set(cacheKey, { fetchedAt: Date.now(), block });
-            return [...blocks, block];
+            // A request from the previous credential scope may finish after rotation.
+            if (this.credentialScope === scope)
+                this.cache.set(cacheKey, { fetchedAt: Date.now(), block });
+            return [block];
         }
         catch (err) {
+            if (credentialScope(resolveFinAppCredentials(this.config)) !== scope)
+                return [];
             if (cached)
-                return [...blocks, withDegradedReason(cached.block, err instanceof Error ? err.message : String(err))];
-            return blocks;
+                return [withDegradedReason(cached.block, err instanceof Error ? err.message : String(err))];
+            // Transient failure must reach the registry so it can reuse a valid snapshot.
+            throw err;
+        }
+    }
+}
+function credentialScope(credentials) {
+    return credentials
+        ? crypto.createHash("sha256").update(JSON.stringify([credentials.baseUrl, credentials.apiKey])).digest("hex")
+        : null;
+}
+function contextCacheKey(threadId, meta) {
+    const userId = typeof meta.userId === "number" ? meta.userId : "unknown";
+    const locale = meta.locale === "zh" ? "zh" : meta.locale === "en" ? "en" : "unknown";
+    const kind = meta.kind === "system" ? "system" : "user";
+    return JSON.stringify([userId, threadId, locale, kind]);
+}
+/** Local client capabilities have their own snapshot and cannot be lost to a remote fetch timeout. */
+export class FinAppClientContextProvider {
+    source = "fin-app-client";
+    selectMessage(input) {
+        return selectFinAppMessage(input);
+    }
+    ownsInterrupt(messages) {
+        return batchHasFinAppFenceCapability(messages);
+    }
+    interruptText(messages) {
+        return finAppCapabilityInterruptText(messages);
+    }
+    build(input) {
+        if (input.channel !== "finapp")
+            return Promise.resolve([]);
+        const blocks = [];
+        const fenceCatalog = typeof input.channelMeta.fenceCatalogPrompt === "string"
+            ? input.channelMeta.fenceCatalogPrompt.trim()
+            : "";
+        if (fenceCatalog) {
+            blocks.push({
+                source: "fin-app-fence-catalog",
+                scope: "thread",
+                threadId: input.threadId,
+                title: "Fin-App fence catalog",
+                generatedAt: new Date().toISOString(),
+                digest: crypto.createHash("sha256").update(fenceCatalog).digest("hex").slice(0, 16),
+                // Above thread context and above the forbid appendix so schemas win.
+                priority: 115,
+                content: fenceCatalog,
+                metadata: {
+                    clientFences: input.channelMeta.clientFences,
+                },
+            });
         }
+        const fencePrompt = typeof input.channelMeta.fenceCapabilityPrompt === "string"
+            ? input.channelMeta.fenceCapabilityPrompt.trim()
+            : "";
+        if (fencePrompt) {
+            blocks.push({
+                source: "fin-app-fences",
+                scope: "thread",
+                threadId: input.threadId,
+                title: "Fin-App client fences",
+                generatedAt: new Date().toISOString(),
+                digest: crypto.createHash("sha256").update(fencePrompt).digest("hex").slice(0, 16),
+                priority: 110,
+                content: fencePrompt,
+                metadata: {
+                    clientFences: input.channelMeta.clientFences,
+                },
+            });
+        }
+        return Promise.resolve(blocks);
+    }
+}
+function selectFinAppMessage(input) {
+    if (input.interrupt) {
+        const latestUpdate = [...input.messages].reverse().find((message) => batchHasFinAppFenceCapability([message]));
+        if (latestUpdate)
+            return latestUpdate;
     }
+    return input.messages.find((message) => message.channel === "finapp");
 }
 function renderFinAppContext(context, messageKind) {
     const lines = [];

package/dist/agent/external-context/providers/finapp.js.map

@@ -1 +1 @@
-{"version":3,"file":"finapp.js","sourceRoot":"","sources":["../../../../src/agent/external-context/providers/finapp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"finapp.js","sourceRoot":"","sources":["../../../../src/agent/external-context/providers/finapp.ts"],"names":[],"mappings":"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"}

package/dist/agent/external-context/registry.d.ts

@@ -1,11 +1,17 @@
 import type { VisionClawConfig } from "../../config/types.js";
 import { type CommandMessage } from "../../channels/interface.js";
 import type { SessionMode } from "../mailbox.js";
-import type { ExternalContextBlock, ExternalContextProvider, ExternalContextRenderResult, ExternalContextTrigger } from "./types.js";
+import type { ExternalContextBlock, ExternalContextCollectionResult, ExternalContextProvider, ExternalContextRenderResult, ExternalContextTrigger, ExternalConversationContext } from "./types.js";
 export interface ExternalContextRegistryOptions {
     maxChars?: number;
     providerTimeoutMs?: number;
 }
+/** Text hooks can contain mandatory contracts; never silently omit a failed hook. */
+export declare class ExternalContextHookError extends Error {
+    readonly source: string;
+    readonly hook: "systemPrompt" | "interruptText";
+    constructor(source: string, hook: "systemPrompt" | "interruptText", cause: unknown);
+}
 export declare class ExternalContextRegistry {
     private readonly providers;
     private readonly maxChars;
@@ -15,7 +21,14 @@ export declare class ExternalContextRegistry {
         trigger: ExternalContextTrigger;
         sessionMode: SessionMode;
         messages: CommandMessage[];
-    }): Promise<ExternalContextRenderResult>;
+        interrupt?: boolean;
+        previousProviderBlocks?: ExternalContextCollectionResult["providerBlocks"];
+    }): Promise<ExternalContextCollectionResult>;
+    systemPrompt(conversation: ExternalConversationContext): string;
+    ownsInterrupt(messages: readonly CommandMessage[]): boolean;
+    private providerOwnsInterrupt;
+    interruptText(messages: readonly CommandMessage[]): string | null;
+    private collectText;
     private buildWithTimeout;
 }
 export declare function createDefaultExternalContextRegistry(config: VisionClawConfig): ExternalContextRegistry;

package/dist/agent/external-context/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agent/external-context/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAEnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EAEvB,2BAA2B,EAC3B,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,SAAS,EAAE,uBAAuB,EAAE,EAAE,OAAO,GAAE,8BAAmC;IAMxF,OAAO,CAAC,KAAK,EAAE;QACnB,OAAO,EAAE,sBAAsB,CAAC;QAChC,WAAW,EAAE,WAAW,CAAC;QACzB,QAAQ,EAAE,cAAc,EAAE,CAAC;KAC5B,GAAG,OAAO,CAAC,2BAA2B,CAAC;YAe1B,gBAAgB;CAoB/B;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,gBAAgB,GAAG,uBAAuB,CAItG;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AA6BD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,EAAE,EAC9B,QAAQ,SAAoB,GAC3B,2BAA2B,CA8B7B"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agent/external-context/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAEnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EACV,oBAAoB,EACpB,+BAA+B,EAC/B,uBAAuB,EAEvB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qFAAqF;AACrF,qBAAa,wBAAyB,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe;gBAA/D,MAAM,EAAE,MAAM,EAAW,IAAI,EAAE,cAAc,GAAG,eAAe,EAAE,KAAK,EAAE,OAAO;CAIrG;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,SAAS,EAAE,uBAAuB,EAAE,EAAE,OAAO,GAAE,8BAAmC;IASxF,OAAO,CAAC,KAAK,EAAE;QACnB,OAAO,EAAE,sBAAsB,CAAC;QAChC,WAAW,EAAE,WAAW,CAAC;QACzB,QAAQ,EAAE,cAAc,EAAE,CAAC;QAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,sBAAsB,CAAC,EAAE,+BAA+B,CAAC,gBAAgB,CAAC,CAAC;KAC5E,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAkC5C,YAAY,CAAC,YAAY,EAAE,2BAA2B,GAAG,MAAM;IAI/D,aAAa,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO;IAI3D,OAAO,CAAC,qBAAqB;IAS7B,aAAa,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,GAAG,IAAI;IAIjE,OAAO,CAAC,WAAW;YAaL,gBAAgB;CAoC/B;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,gBAAgB,GAAG,uBAAuB,CAMtG;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AA6BD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,EAAE,EAC9B,QAAQ,SAAoB,GAC3B,2BAA2B,CA8B7B"}

package/dist/agent/external-context/registry.js

@@ -1,51 +1,131 @@
 import crypto from "node:crypto";
 import { resolveThreadId } from "../../channels/interface.js";
 import { logger } from "../../logger.js";
-import { FinAppExternalContextProvider } from "./providers/finapp.js";
+import { FinAppClientContextProvider, FinAppExternalContextProvider } from "./providers/finapp.js";
 const DEFAULT_MAX_CHARS = 12_000;
 const DEFAULT_PROVIDER_TIMEOUT_MS = 1_000;
+/** Text hooks can contain mandatory contracts; never silently omit a failed hook. */
+export class ExternalContextHookError extends Error {
+    source;
+    hook;
+    constructor(source, hook, cause) {
+        super(`External context provider ${source} ${hook} failed`, { cause });
+        this.source = source;
+        this.hook = hook;
+        this.name = "ExternalContextHookError";
+    }
+}
 export class ExternalContextRegistry {
     providers;
     maxChars;
     providerTimeoutMs;
     constructor(providers, options = {}) {
+        if (new Set(providers.map((provider) => provider.source)).size !== providers.length) {
+            throw new Error("External context provider sources must be unique");
+        }
         this.providers = providers;
         this.maxChars = options.maxChars ?? DEFAULT_MAX_CHARS;
         this.providerTimeoutMs = options.providerTimeoutMs ?? DEFAULT_PROVIDER_TIMEOUT_MS;
     }
     async collect(input) {
-        const providerInput = normalizeProviderInput(input.trigger, input.sessionMode, input.messages);
-        const settled = await Promise.all(this.providers.map((provider) => this.buildWithTimeout(provider, providerInput)));
-        const blocks = settled.flat().sort((a, b) => b.priority - a.priority || a.source.localeCompare(b.source));
+        const providerInput = { ...normalizeProviderInput(input.trigger, input.sessionMode, input.messages), interrupt: input.interrupt };
+        const settled = await Promise.all(this.providers.map(async (provider) => {
+            // Check validity at the moment of fallback: credentials may change while build awaits I/O.
+            const previous = () => {
+                const blocks = input.previousProviderBlocks?.get(provider.source) ?? [];
+                try {
+                    return !provider.canReuseContext || provider.canReuseContext(providerInput, blocks) ? blocks : [];
+                }
+                catch (err) {
+                    logger.warn(`[external-context] provider ${provider.source} snapshot check failed: ${err instanceof Error ? err.message : String(err)}`);
+                    return [];
+                }
+            };
+            // An interrupt updates only the providers that own it. Others retain
+            // their wake-start context, even when this batch has no message for them.
+            const blocks = input.interrupt && !this.providerOwnsInterrupt(provider, input.messages)
+                ? previous()
+                : await this.buildWithTimeout(provider, providerInput)
+                    ?? previous();
+            return [provider.source, blocks];
+        }));
+        const providerBlocks = new Map(settled);
+        const blocks = settled.flatMap(([, blocks]) => blocks).sort((a, b) => b.priority - a.priority || a.source.localeCompare(b.source));
         const rendered = renderExternalContextBlocks(blocks, this.maxChars);
         if (rendered.blocks.length > 0) {
             logger.system(`external_context_injected sources=${JSON.stringify([...new Set(rendered.blocks.map((b) => b.source))])} threadId=${providerInput.threadId} digests=${JSON.stringify(rendered.blocks.map((b) => b.digest))} totalChars=${rendered.totalChars} truncated=${rendered.truncated}`);
         }
-        return rendered;
+        return { ...rendered, providerBlocks };
+    }
+    systemPrompt(conversation) {
+        return this.collectText("systemPrompt", (provider) => provider.systemPrompt?.(conversation));
+    }
+    ownsInterrupt(messages) {
+        return this.providers.some((provider) => this.providerOwnsInterrupt(provider, messages));
+    }
+    providerOwnsInterrupt(provider, messages) {
+        try {
+            return provider.ownsInterrupt?.(messages) ?? false;
+        }
+        catch (err) {
+            logger.warn(`[external-context] provider ${provider.source} interrupt check failed: ${err instanceof Error ? err.message : String(err)}`);
+            return false;
+        }
+    }
+    interruptText(messages) {
+        return this.collectText("interruptText", (provider) => provider.interruptText?.(messages)) || null;
+    }
+    collectText(hook, read) {
+        return this.providers.map((provider) => {
+            try {
+                return read(provider)?.trim() ?? null;
+            }
+            catch (err) {
+                throw new ExternalContextHookError(provider.source, hook, err);
+            }
+        }).filter((text) => Boolean(text)).join("\n\n");
     }
     async buildWithTimeout(provider, input) {
         let timeout;
+        const controller = new AbortController();
         try {
+            input = { ...input, signal: controller.signal };
+            if (provider.selectMessage) {
+                const primaryMessage = provider.selectMessage(input);
+                input = {
+                    ...input,
+                    primaryMessage,
+                    threadId: primaryMessage ? resolveThreadId(primaryMessage) : "default",
+                    channel: primaryMessage?.channel ?? null,
+                    channelMeta: primaryMessage?.meta ?? {},
+                };
+            }
             return await Promise.race([
                 provider.build(input),
                 new Promise((resolve) => {
-                    timeout = setTimeout(() => resolve([]), this.providerTimeoutMs);
+                    timeout = setTimeout(() => {
+                        logger.warn(`[external-context] provider ${provider.source} timed out`);
+                        resolve(null);
+                    }, this.providerTimeoutMs);
                     timeout.unref();
                 }),
             ]);
         }
         catch (err) {
             logger.warn(`[external-context] provider ${provider.source} failed: ${err instanceof Error ? err.message : String(err)}`);
-            return [];
+            return null;
         }
         finally {
             if (timeout)
                 clearTimeout(timeout);
+            controller.abort();
         }
     }
 }
 export function createDefaultExternalContextRegistry(config) {
+    // Other built-in integration hooks: channels/credential-backed.ts and event-trigger/wake-routing.ts.
     return new ExternalContextRegistry([
+        new FinAppClientContextProvider(),
         new FinAppExternalContextProvider(config),
     ]);
 }
@@ -53,7 +133,7 @@ export function digestExternalContextContent(content) {
     return crypto.createHash("sha256").update(content).digest("hex").slice(0, 16);
 }
 function normalizeProviderInput(trigger, sessionMode, messages) {
-    const primaryMessage = messages.find((m) => m.channel === "finapp") ?? messages.at(0);
+    const primaryMessage = messages.at(0);
     if (!primaryMessage) {
         return {
             trigger,