@fiodos/web-core 0.1.12 → 0.1.15

package/dist/cjs/adapters/webCredentialAutofillAdapter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Web implementation of @fiodos/core's CredentialAutofillAdapter, on top of
+ * the Credential Management API (`navigator.credentials.get({ password: true,
+ * mediation: 'required' })`). The BROWSER owns the account-picker / user
+ * verification UI; this module only receives the outcome:
+ *
+ * - A `PasswordCredential` → 'success' with the saved username + password.
+ * - `null` (user dismissed the picker, or no saved credential and the browser
+ *   chose not to prompt) → 'dismissed' (graceful fallback, never an error).
+ * - No API / SecurityError (insecure context, iframe policy) → 'unavailable'.
+ *
+ * The credentials never touch storage, logs or the network from here: they go
+ * straight into the app's own login handler parameters, one call, then gone.
+ */
+import type { CredentialAutofillAdapter } from '@fiodos/core';
+export declare function createWebCredentialAutofillAdapter(): CredentialAutofillAdapter;

package/dist/cjs/adapters/webCredentialAutofillAdapter.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebCredentialAutofillAdapter = createWebCredentialAutofillAdapter;
+function credentialsContainer() {
+    if (typeof navigator === 'undefined')
+        return null;
+    const nav = navigator;
+    return nav.credentials && typeof nav.credentials.get === 'function' ? nav.credentials : null;
+}
+function passwordCredentialSupported() {
+    if (typeof window === 'undefined')
+        return false;
+    const w = window;
+    // The Credential Management password store needs both the constructor and a
+    // secure context; feature-detect instead of sniffing the browser.
+    return typeof w.PasswordCredential === 'function' && w.isSecureContext !== false;
+}
+function createWebCredentialAutofillAdapter() {
+    return {
+        isSupported() {
+            return credentialsContainer() !== null && passwordCredentialSupported();
+        },
+        async requestCredentials() {
+            const container = credentialsContainer();
+            if (!container || !passwordCredentialSupported())
+                return { status: 'unavailable' };
+            let raw;
+            try {
+                // mediation 'required': ALWAYS show the browser's account picker — the
+                // user explicitly asked to sign in, so a visible, cancellable choice is
+                // the honest UX (and the only one that lets them pick among accounts).
+                raw = await container.get({ password: true, mediation: 'required' });
+            }
+            catch {
+                // SecurityError (permissions policy / insecure frame), NotSupportedError…
+                return { status: 'unavailable' };
+            }
+            const cred = raw;
+            if (!cred)
+                return { status: 'dismissed' };
+            if (cred.type === 'password' && cred.id && typeof cred.password === 'string' && cred.password) {
+                return { status: 'success', username: cred.id, password: cred.password };
+            }
+            return { status: 'unavailable' };
+        },
+    };
+}

package/dist/cjs/api/backendClient.d.ts

@@ -6,7 +6,7 @@
  * way. The only platform dependency is `fetch` + `AbortController` (native in
  * the browser). No client source code is ever sent — only the manifest payload.
  */
-import { type AgentBackendClient, type AppManifest } from '@fiodos/core';
+import { type ActionRegistries, type AgentBackendClient, type AppManifest } from '@fiodos/core';
 export interface FiodosBackendClientOptions {
     baseUrl: string;
     /** Client API key sent as x-api-key. */
@@ -19,8 +19,15 @@ export interface FiodosBackendClientOptions {
     ttsTimeoutMs?: number;
 }
 export declare function createFiodosBackendClient(options: FiodosBackendClientOptions): AgentBackendClient;
-/** Serializes the manifest payloads for a turn request (used by AgentController). */
-export declare function buildManifestPayload(manifest: AppManifest): {
+/**
+ * Serializes the manifest payloads for a turn request (used by AgentController).
+ *
+ * When the live registries are provided, actions with no registered handler
+ * are dropped from the payload (runtime "wired or nonexistent"): the LLM never
+ * hears about an action this mounted app cannot execute, so it can never
+ * promise it. Fail-open without registries.
+ */
+export declare function buildManifestPayload(manifest: AppManifest, registries?: ActionRegistries | null): {
     appFlow?: string | undefined;
     appType?: string | undefined;
     manifestVersion: string;

package/dist/cjs/api/backendClient.js

@@ -119,6 +119,20 @@ function createFiodosBackendClient(options) {
             if (request.sessionId?.trim()) {
                 body.session_id = request.sessionId.trim();
             }
+            // Device capability flags (retrocompatible: old backends ignore them).
+            if (request.platformCapabilities?.credentialAutofill) {
+                body.platform_capabilities = { credential_autofill: true };
+            }
+            // Live session verdict for audience filtering (retrocompatible: absent
+            // when the host wired no session source; old backends ignore it).
+            if (request.sessionContext) {
+                body.session_context = {
+                    authenticated: request.sessionContext.authenticated,
+                    ...(request.sessionContext.capabilities
+                        ? { capabilities: request.sessionContext.capabilities }
+                        : {}),
+                };
+            }
             // Autonomous-chain continuation metadata (backward compatible: absent on a
             // normal turn; an old backend simply ignores these fields).
             if (request.isContinuation) {
@@ -188,15 +202,23 @@ function createFiodosBackendClient(options) {
         },
     };
 }
-/** Serializes the manifest payloads for a turn request (used by AgentController). */
-function buildManifestPayload(manifest) {
+/**
+ * Serializes the manifest payloads for a turn request (used by AgentController).
+ *
+ * When the live registries are provided, actions with no registered handler
+ * are dropped from the payload (runtime "wired or nonexistent"): the LLM never
+ * hears about an action this mounted app cannot execute, so it can never
+ * promise it. Fail-open without registries.
+ */
+function buildManifestPayload(manifest, registries) {
+    const effective = (0, core_1.withExecutableActions)(manifest, registries);
     return {
-        manifestVersion: manifest.version,
-        manifestRoutes: (0, core_1.manifestRoutesForBackend)(manifest),
-        manifestActions: (0, core_1.manifestActionsForBackend)(manifest),
-        appName: manifest.appName,
-        appDescription: manifest.appDescription,
-        ...(manifest.appType ? { appType: manifest.appType } : {}),
-        ...(manifest.appFlow ? { appFlow: manifest.appFlow } : {}),
+        manifestVersion: effective.version,
+        manifestRoutes: (0, core_1.manifestRoutesForBackend)(effective),
+        manifestActions: (0, core_1.manifestActionsForBackend)(effective),
+        appName: effective.appName,
+        appDescription: effective.appDescription,
+        ...(effective.appType ? { appType: effective.appType } : {}),
+        ...(effective.appFlow ? { appFlow: effective.appFlow } : {}),
     };
 }

package/dist/cjs/config/types.d.ts

@@ -3,7 +3,7 @@
  * Mirrors @fiodos/react's FiodosWebAgentConfig (same adapters, same lifecycle).
  * Shared by every framework binding through the AgentController.
  */
-import type { ActionRegistries, AgentBackendClient, AgentMessages, AppManifest, ConfirmationLexicon, MessageCatalog, NavigationAdapter, Sanitizer, StorageAdapter, TelemetryAdapter, VoiceAdapter } from '@fiodos/core';
+import type { ActionRegistries, AgentBackendClient, AgentMessages, AppManifest, ConfirmationLexicon, CredentialAutofillAdapter, MessageCatalog, NavigationAdapter, Sanitizer, StorageAdapter, TelemetryAdapter, VoiceAdapter } from '@fiodos/core';
 import type { ResolveUiMessagesOptions, WebUiMessages } from '../ui/messages';
 export type AgentPhase = 'idle' | 'listening' | 'thinking' | 'speaking' | 'confirming';
 export interface AgentTimings {
@@ -44,6 +44,13 @@ export interface FiodosWebAgentConfig {
     manifest: AppManifest;
     /** Agent locale (reply language, message catalogs). MANDATORY. */
     locale: string;
+    /**
+     * LIVE locale resolver. When set, the orb re-reads it periodically so the
+     * thought bubble follows the app's ACTIVE language (host language switcher,
+     * `<html lang>`, i18n runtime) without remounting. Falls back to `locale`
+     * whenever it returns nothing.
+     */
+    getLocale?: () => string | null | undefined;
     /** Speech recognition locale, e.g. 'en-US', 'es-ES'. MANDATORY. */
     sttLocale: string;
     /** Device-TTS fallback locale. Defaults to sttLocale. */
@@ -55,7 +62,20 @@ export interface FiodosWebAgentConfig {
     storage: StorageAdapter;
     telemetry?: TelemetryAdapter;
     /** Host auth check, required by manifest actions declaring requiresAuth. */
-    isAuthenticated?: () => boolean;
+    isAuthenticated?: () => boolean | null | undefined;
+    /**
+     * Fine-grained session capability flags from the wired session bridge
+     * (audience map: e.g. { has_payment_method: true }). Sent with each turn so
+     * the backend shows this user only THEIR face of the orb. Boolean flags
+     * only — never user data. null/undefined = unknown (nothing is filtered).
+     */
+    getSessionCapabilities?: () => Record<string, boolean> | null | undefined;
+    /**
+     * Platform saved-credential service powering the built-in SMART SIGN-IN
+     * flow (browser password manager). Defaults to the web Credential
+     * Management adapter; pass `null` to disable the feature entirely.
+     */
+    credentialAutofill?: CredentialAutofillAdapter | null;
     /**
      * Host end-user identity. Conversation memory is namespaced per identity
      * (hashed LOCALLY, never sent by this module): logout/account switches swap

package/dist/cjs/controller/AgentController.d.ts

@@ -74,6 +74,7 @@ export declare class AgentController {
     private readonly telemetry;
     private readonly consent;
     private readonly executor;
+    private readonly credentialAutofill;
     private readonly timings;
     private readonly chaining;
     private readonly ttsLocale;
@@ -191,6 +192,19 @@ export declare class AgentController {
     confirmPendingAction(): Promise<void>;
     cancelPendingAction(): void;
     private handleConfirmationTranscript;
+    /**
+     * Device capability flags advertised on each turn (never user data). Fresh
+     * per turn: cheap, and honest if the environment changes mid-session.
+     */
+    private platformCapabilities;
+    /**
+     * Live session verdict advertised on each turn (audience map — never user
+     * data): whether the user is signed in plus the app's boolean capability
+     * flags. Fresh per turn so login/logout mid-session is honest. Undefined
+     * when the host wired neither source (older installs — backend filters
+     * nothing, exactly today's behavior).
+     */
+    private sessionContext;
     private routeLabel;
     private actionLabel;
     /**

package/dist/cjs/controller/AgentController.js

@@ -19,6 +19,7 @@ exports.AgentController = void 0;
  *  - The agent only ever executes actions declared in the manifest.
  */
 const core_1 = require("@fiodos/core");
+const webCredentialAutofillAdapter_1 = require("../adapters/webCredentialAutofillAdapter");
 const errors_1 = require("../api/errors");
 const formatTurnError_1 = require("../api/formatTurnError");
 const backendClient_1 = require("../api/backendClient");
@@ -94,12 +95,19 @@ class AgentController {
             appId: config.manifest.appId,
             version: config.consentVersion,
         });
+        // SMART SIGN-IN ships by default on web (browser password manager);
+        // hosts can override the adapter or pass null to opt out entirely.
+        this.credentialAutofill =
+            config.credentialAutofill === undefined
+                ? (0, webCredentialAutofillAdapter_1.createWebCredentialAutofillAdapter)()
+                : config.credentialAutofill;
         this.executor = (0, core_1.createActionExecutor)({
             manifest: config.manifest,
             registries: config.registries,
             navigation: config.navigation,
             messages: this.messages,
             isAuthenticated: config.isAuthenticated,
+            credentialAutofill: this.credentialAutofill,
         });
         this.timings = { ...types_1.DEFAULT_AGENT_TIMINGS, ...config.timings };
         // Chaining OFF by default; clamp to the same safe bounds as react/react-native.
@@ -584,6 +592,57 @@ class AgentController {
                 this.beginConfirmationVoiceWindow();
         }
     }
+    /**
+     * Device capability flags advertised on each turn (never user data). Fresh
+     * per turn: cheap, and honest if the environment changes mid-session.
+     */
+    platformCapabilities() {
+        let autofill = false;
+        try {
+            autofill = this.credentialAutofill?.isSupported() === true;
+        }
+        catch {
+            autofill = false;
+        }
+        return autofill ? { credentialAutofill: true } : undefined;
+    }
+    /**
+     * Live session verdict advertised on each turn (audience map — never user
+     * data): whether the user is signed in plus the app's boolean capability
+     * flags. Fresh per turn so login/logout mid-session is honest. Undefined
+     * when the host wired neither source (older installs — backend filters
+     * nothing, exactly today's behavior).
+     */
+    sessionContext() {
+        const { isAuthenticated, getSessionCapabilities } = this.config;
+        if (!isAuthenticated && !getSessionCapabilities)
+            return undefined;
+        let authenticated = null;
+        try {
+            const v = isAuthenticated?.();
+            authenticated = v == null ? null : Boolean(v);
+        }
+        catch {
+            authenticated = null;
+        }
+        let capabilities;
+        try {
+            const raw = getSessionCapabilities?.();
+            if (raw && typeof raw === 'object') {
+                const clean = {};
+                for (const [k, v] of Object.entries(raw)) {
+                    if (typeof v === 'boolean')
+                        clean[k] = v;
+                }
+                if (Object.keys(clean).length > 0)
+                    capabilities = clean;
+            }
+        }
+        catch {
+            capabilities = undefined;
+        }
+        return { authenticated, ...(capabilities ? { capabilities } : {}) };
+    }
     routeLabel(intent) {
         return this.config.manifest.routes.find((r) => r.intent === intent)?.label;
     }
@@ -769,7 +828,9 @@ class AgentController {
                         isContinuation: true,
                         chainStep: step,
                         lastStep,
-                        ...(0, backendClient_1.buildManifestPayload)(this.config.manifest),
+                        platformCapabilities: this.platformCapabilities(),
+                        sessionContext: this.sessionContext(),
+                        ...(0, backendClient_1.buildManifestPayload)(this.config.manifest, this.config.registries),
                     }, { signal: controller.signal });
                     oc = await this.applyOutcome(turn, routeNow, snap?.context ?? {}, state.userMessage);
                 }
@@ -926,7 +987,9 @@ class AgentController {
                 conversationHistory: conv.history,
                 conversationSummary: conv.summary ?? undefined,
                 sessionId: this.sessionId,
-                ...(0, backendClient_1.buildManifestPayload)(this.config.manifest),
+                platformCapabilities: this.platformCapabilities(),
+                sessionContext: this.sessionContext(),
+                ...(0, backendClient_1.buildManifestPayload)(this.config.manifest, this.config.registries),
             }, { signal: controller.signal });
             outcome = await this.applyOutcome(turn, currentRoute, snapshot?.context ?? {}, text);
         }

package/dist/cjs/dropin/createFiodosAgent.d.ts

@@ -13,6 +13,7 @@
  */
 import { type ActionRegistries, type AppManifest } from '@fiodos/core';
 import { AgentController } from '../controller/AgentController';
+import type { AgentScreenSnapshot } from '../context/screenContextStore';
 import { type MountOrbOptions, type MountedOrb } from '../orb/mountOrb';
 import type { FiodosWebAgentConfig } from '../config/types';
 export interface CreateFiodosAgentOptions {
@@ -37,8 +38,22 @@ export interface CreateFiodosAgentOptions {
     sttLocale?: string;
     /** Host router navigate delegate. Defaults to location.assign. */
     navigate?: (route: string) => void;
+    /**
+     * Current route/screen resolver for the agent's screen awareness. Defaults
+     * to location.pathname + search. Apps whose screens are CLIENT STATE (no URL
+     * change) pass the generated `fyodosGetCurrentRoute` here so the orb knows
+     * which screen the user is on (see screen-truth wiring).
+     */
+    getCurrentRoute?: () => string | null;
     /** Host auth check for actions requiring auth. */
-    isAuthenticated?: () => boolean;
+    isAuthenticated?: () => boolean | null | undefined;
+    /**
+     * Fine-grained session capability flags (audience map, e.g.
+     * { has_payment_method: true }) from the generated session wiring. Boolean
+     * flags only; sent with each turn so the orb shows this user only THEIR
+     * available actions.
+     */
+    getSessionCapabilities?: () => Record<string, boolean> | null | undefined;
     /** Voice id forwarded to the backend TTS. */
     ttsVoice?: string | (() => string | undefined);
     /** End-user id for rate limiting / telemetry correlation. */
@@ -64,6 +79,17 @@ export interface FiodosAgentHandle {
      * Call it from the app's logout for a hard wipe; no-op until ready.
      */
     resetConversation(): void;
+    /**
+     * Publishes WHAT THE USER IS SEEING so 'execute' actions can target it —
+     * the embed-host equivalent of the React `useAgentScreenContext` hook.
+     * Hosts without our SDK on screens (Dynamics web resources, WinCC CWCs)
+     * call this whenever their form/record/view changes. On the auto-fetch
+     * path, calls made before the controller is ready are kept and applied on
+     * ready, so hosts don't need to await `ready` themselves.
+     */
+    setScreenContext(snapshot: AgentScreenSnapshot): void;
+    /** Clears a previously published snapshot (e.g. the record was closed). */
+    clearScreenContext(): void;
     destroy(): void;
 }
 export declare function createFiodosAgent(options: CreateFiodosAgentOptions): FiodosAgentHandle;

package/dist/cjs/dropin/createFiodosAgent.js

@@ -32,6 +32,11 @@ function browserLocale() {
     const lang = typeof navigator !== 'undefined' && navigator.language ? navigator.language : 'en-US';
     return { locale: lang.split('-')[0] || 'en', sttLocale: lang };
 }
+function documentLocale() {
+    return typeof document !== 'undefined'
+        ? document.documentElement.lang?.split(/[-_]/)[0]?.trim() || ''
+        : '';
+}
 function resolveAgentLocale(options) {
     const fromApp = options.getLocale?.()?.trim();
     if (fromApp)
@@ -41,12 +46,16 @@ function resolveAgentLocale(options) {
     if (options.localeDetection === 'browser')
         return browserLocale().locale;
     if (options.localeDetection === 'document') {
-        const docLang = typeof document !== 'undefined'
-            ? document.documentElement.lang?.split(/[-_]/)[0]?.trim()
-            : '';
+        const docLang = documentLocale();
         if (docLang)
             return docLang;
     }
+    // Default (nothing configured): follow the HOST PAGE's language when the
+    // page declares one (<html lang>), so the orb bubble speaks the language the
+    // end user is actually browsing in. English only as the last resort.
+    const docLang = documentLocale();
+    if (docLang)
+        return docLang;
     return 'en';
 }
 /** Build the controller + adapters from a known manifest (shared by both paths). */
@@ -67,14 +76,22 @@ function assemble(options, manifest, baseUrl) {
     const config = {
         manifest,
         locale,
+        // Live resolver: re-runs the same resolution chain (app getLocale → static
+        // locale → detection) on every read, so the bubble follows the host app's
+        // language switcher / <html lang> without remounting the agent.
+        getLocale: () => resolveAgentLocale(options),
         sttLocale,
-        navigation: (0, webNavigationAdapter_1.createWebNavigationAdapter)({ navigate: options.navigate ?? defaultNavigate }),
+        navigation: (0, webNavigationAdapter_1.createWebNavigationAdapter)({
+            navigate: options.navigate ?? defaultNavigate,
+            getCurrentRoute: options.getCurrentRoute,
+        }),
         registries: options.registries ?? { handlers: {}, idempotencyCheckers: {} },
         backend,
         voice: (0, webVoiceAdapter_1.createWebVoiceAdapter)(),
         storage: (0, webStorageAdapter_1.createWebStorageAdapter)(),
         telemetry,
         isAuthenticated: options.isAuthenticated,
+        getSessionCapabilities: options.getSessionCapabilities,
         getUserId: options.getUserId,
         ttsVoice: options.ttsVoice,
         ...options.configOverrides,
@@ -86,6 +103,9 @@ function assemble(options, manifest, baseUrl) {
 function createFiodosAgent(options) {
     const baseUrl = (options.baseUrl ?? clientBootstrap_1.DEFAULT_WEB_API_URL).replace(/\/$/, '');
     const shouldMount = options.mount !== false;
+    // One stable owner id per handle: the host is "one screen" from the store's
+    // point of view, so consecutive setScreenContext calls replace each other.
+    const contextOwner = Symbol('fiodos-embed-host');
     // ── Manual path: manifest provided → fully synchronous (back-compat). ───────
     if (options.manifest) {
         const controller = assemble(options, options.manifest, baseUrl);
@@ -101,6 +121,12 @@ function createFiodosAgent(options) {
             resetConversation() {
                 controller.resetConversation();
             },
+            setScreenContext(snapshot) {
+                controller.screenStore.set(contextOwner, snapshot);
+            },
+            clearScreenContext() {
+                controller.screenStore.clear(contextOwner);
+            },
             destroy() {
                 orb?.unmount();
                 controller.dispose();
@@ -109,6 +135,9 @@ function createFiodosAgent(options) {
         return handle;
     }
     // ── Auto path (React parity): fetch manifest by apiKey, then assemble. ──────
+    // Context published before the controller resolves is buffered (last one
+    // wins) and applied on ready — hosts fire form events without awaiting us.
+    let pendingSnapshot;
     const handle = {
         controller: null,
         orb: null,
@@ -116,6 +145,18 @@ function createFiodosAgent(options) {
         resetConversation() {
             handle.controller?.resetConversation();
         },
+        setScreenContext(snapshot) {
+            if (handle.controller)
+                handle.controller.screenStore.set(contextOwner, snapshot);
+            else
+                pendingSnapshot = snapshot;
+        },
+        clearScreenContext() {
+            if (handle.controller)
+                handle.controller.screenStore.clear(contextOwner);
+            else
+                pendingSnapshot = null;
+        },
         destroy() {
             cancelled = true;
             handle.orb?.unmount();
@@ -151,6 +192,9 @@ function createFiodosAgent(options) {
                 return null;
             }
             handle.controller = controller;
+            if (pendingSnapshot)
+                controller.screenStore.set(contextOwner, pendingSnapshot);
+            pendingSnapshot = undefined;
             handle.orb = shouldMount ? (0, mountOrb_1.mountOrb)(controller, options.orb) : null;
             if (shouldMount && options.apiKey) {
                 void (0, clientBootstrap_1.sendOrbSeen)({ baseUrl, apiKey: options.apiKey });

package/dist/cjs/embed/dynamics.d.ts

@@ -0,0 +1,61 @@
+import type { AgentScreenSnapshot } from '../context/screenContextStore';
+interface XrmAttributeLike {
+    getName(): string;
+    getValue(): unknown;
+    /** Present on optionset/lookup attributes; preferred over raw values. */
+    getText?(): string | string[] | null;
+}
+interface XrmEntityLike {
+    getEntityName(): string;
+    /** Record GUID, usually brace-wrapped: "{1D2C...}". Empty on create forms. */
+    getId(): string;
+    getPrimaryAttributeValue?(): string | null;
+    attributes?: {
+        forEach(cb: (attribute: XrmAttributeLike) => void): void;
+    };
+    /** Model-driven apps expose save events here (Xrm ≥ 9.x). */
+    addOnPostSave?(handler: () => void): void;
+    removeOnPostSave?(handler: () => void): void;
+}
+export interface DynamicsFormContextLike {
+    data: {
+        entity: XrmEntityLike;
+    };
+    ui?: {
+        getFormType?(): number;
+    };
+}
+/** The subset of FiodosAgentHandle the bridge needs (keeps this module cheap to test). */
+export interface ScreenContextSink {
+    setScreenContext(snapshot: AgentScreenSnapshot): void;
+    clearScreenContext(): void;
+}
+export interface DynamicsSnapshotOptions {
+    /**
+     * Logical names of the attributes to expose to the agent. When omitted, the
+     * first `maxAttributes` non-empty scalar attributes are included.
+     */
+    attributes?: string[];
+    /** Cap when no allowlist is given. Default 12. */
+    maxAttributes?: number;
+}
+/** "{1D2C…}" → "1d2c…" (Web API URLs want bare lowercase GUIDs). */
+export declare function normalizeDynamicsId(rawId: string): string;
+/**
+ * Builds the AgentScreenSnapshot for the current form state, or null when
+ * there is nothing referenceable yet (create form: no record id).
+ */
+export declare function dynamicsFormSnapshot(formContext: DynamicsFormContextLike, options?: DynamicsSnapshotOptions): AgentScreenSnapshot | null;
+export interface DynamicsContextBridge {
+    /** Re-reads the form and republishes the snapshot (wire to OnChange/OnSave). */
+    refresh(): void;
+    /** Stops publishing and clears the agent's screen context. */
+    disconnect(): void;
+}
+/**
+ * Publishes the form snapshot now, republishes after every save (when the
+ * form exposes OnPostSave), and clears the context on disconnect. Call it from
+ * the form's OnLoad handler.
+ */
+export declare function connectDynamicsFormContext(agent: ScreenContextSink, formContext: DynamicsFormContextLike, options?: DynamicsSnapshotOptions): DynamicsContextBridge;
+export {};