@tinkerlandai/longplay-sdk 0.10.7 → 0.10.11

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.10.11 — 2026-11-02
+
+- Add opt-in managed Funnel processes: create or reuse a Guest and bind a verified login to the same Run, including accounts that already have a Customer.
+- Preserve anonymous answers, accepted history, Run credentials and command recovery across login; keep commercial Customer ownership separate from the original Participant.
+- Add the merchant backend's durable process adapter, Web/React Native process and IAM hosts, and Swift/Kotlin process bridges. Backend credentials stay outside the client and command journal.
+- Retain original binding intents after lost replies, isolate account switches and revoke only the process's own session on logout. Existing Funnel Versions and wire protocol `0.10` are preserved.
+
+## 0.10.10 — 2026-11-01
+
+- Preserve Funnel commands and purchase recovery through concurrent responses, failed persistence and native pending results; avoid stale Paywall quotes and leaked sessions.
+- Fence refreshed credentials against account changes, coalesce configuration cache work and retain exact exposure and Messaging retry identities.
+- Render native Content with the bundled renderer, report failed starts and return an explicit busy response when the native bridge is full.
+- Cancel and release native HTTP streams promptly; keep Python and Go network waits outside session state locks.
+- Classify invalid Android usage commands as request errors before invoking the merchant relay.
+
+## 0.10.8 — 2026-11-01
+
+- Recover IAM entry background Waits and unknown starts after reload by replaying the original start request under the same Customer and build, without persisting credentials or allocating another Run.
+
+- Start one IAM entry Run when a router renders a back/forward page before the host observes the popstate.
+- Present automatic IAM entries at most once per visit; dismissing or completing a Run no longer starts another Funnel on the same page.
+- Hide paused or timer/event-waiting entry Runs, report `run_background`, and let other entries take the page instead of showing bare controls.
+- Reread an open page's visual experiment payload every 60 seconds while visible, so stopped experiments revert without a reload.
+- Close a shown entry screen Run when the page unloads, the host is destroyed or the Customer changes, so a reload or account switch no longer suppresses that Funnel's entries until the Run expires.
+
 ## 0.10.7 — 2026-11-01
 
 - Require the clicked node itself to remain the unique active IAM target; hidden or detached controls cannot borrow a replacement's anchor.
@@ -10,7 +35,6 @@
 
 Only Longplay public factories, errors, types and browser globals are supported. Migrate old Indiana imports to their Longplay names. Internal implementations, protocol and saved identities are unchanged; previously published artifacts remain immutable.
 
-
 ## 0.10.5 — 2026-11-01
 
 - Make IAM Funnel entries recover from configuration timeouts, delayed scene changes, hidden retained pages and earlier refused entries; recheck the selected scene before mounting a Run.

package/README.md

@@ -137,7 +137,7 @@ longplay.reset();
 
 The SDK refreshes its Access/Refresh pair directly with GOP. Access lasts at most one hour, Refresh at most 24 hours per rotation, within the original 30-day session limit. Successful rotation preserves the Customer identity and pending work; a definitive refresh refusal or expired Refresh Token clears the credentials and requires a new verified login. Business requests do not extend expiry or automatically replay after refresh. Revocation and issuer expiry still apply. See [Customer credentials](../../docs/customer-credentials.md).
 
-Customer updates are partial patches and do not use a Customer revision. When a Guest signs in to an existing Customer, the response reports `switched: true`. Resources and history keep their original owner; create a new Session/Funnel for the target Customer. Guest financial facts are not merged.
+Customer updates are partial patches and do not use a Customer revision. Direct Guest claim reports `switched: true` when the account already has a Customer; legacy Runs keep their original Customer. Use the [managed process](#guest-entry-and-same-run-login) API when login must continue the current Funnel. Guest financial facts are not merged.
 
 ## Optional stable fingerprint
 
@@ -173,13 +173,47 @@ In a browser, use `createFunnelRunController` and `showFunnelRun`. The controlle
 
 Each Funnel chooses local or remote evaluation. `createFunnelDecisionClient` supports `configuration()`, `features()`, submission, and result reads. `createFeatureClient` identifies configuration by `generation`. Downloaded local rules are visible to clients; use remote evaluation and verified business facts for sensitive decisions.
 
+### Guest entry and same-Run login
+
+Publish a Version with `executionContract: "funnel-process/1"` and use the managed process entry points. Existing Versions and `/funnels` retain their execution contract. This addition uses wire protocol `0.10` and requires the matching runtime and SQL deployment.
+
+On the merchant backend, create `createFunnelProcessAdapter` from the `/server` entry. Supply the scoped Server Key, encrypted durable `store.read/compareAndSwap`, `resolveContext(request)` and `resolveUser(request)`. The context resolver validates an acknowledged HttpOnly/native handle and returns `{processKey, guestKey, confirmed: true}`. The user resolver verifies the merchant's live session and returns `{externalUserId}` or an explicit `null`; authentication failures must throw. Never take the account ID from an untrusted request field.
+
+Expose the adapter's operation-specific calls through your backend. Keep Guest proofs, Customer sessions and the Server Key there. A shared `guestKey` reuses an eligible Guest across process handles; one `processKey` retains its original start, bind and recovery intents.
+
+```ts
+import { createConfigurationSync, createFunnelProcess } from "@tinkerlandai/longplay-sdk";
+
+const configuration = createConfigurationSync({
+  origin: baseUrl,
+  scope: { ...scope, environmentId },
+});
+const process = createFunnelProcess({
+  scope,
+  configuration,
+  adapter: merchantBridge,
+  onAuthenticationRequired: () => showMerchantSignIn(),
+});
+const { controller } = await process.open({
+  operation: "start", funnelId, locale: "en", parameters: {},
+});
+// After verified merchant login, retain this instance and controller.
+await process.syncIdentity();
+// Before merchant logout, revoke this process's session and clear its private view.
+await process.detach();
+```
+
+Local execution needs the shared public configuration manager and a published configuration. Login binds the current Run to the account's existing Customer without replacing the Run, answers, history, pinned Version or deadlines. A new account can claim the Guest Customer in place. Another account cannot take over a bound Run; use a new process handle. Commercial assets and historical Customer ownership are preserved.
+
+Web IAM hosts opt in with `createIamFunnelProcessEntries`. React Native exports `createFunnelProcess`; Swift and Kotlin expose `LongplayFunnelProcess` and `LongplayFunnelProcessBridge` over the same merchant backend. Native hosts retain their command-storage adapter and presentation session across login. See the [identity contract](../../docs/funnel-customer-get-or-create.md#宿主接入) for storage, attribution and recovery details.
+
 ### Bucketing identity across independent consumers
 
 Funnel, standalone Features and page experiments evaluate independently. Matching App/environment, experiment definition, attributes, hash identity and Sticky state produce matching results; different refresh times or inputs may produce different variations. A Remote Funnel still evaluates on Longplay when its referenced code Experiment allows Local definition delivery. Accepted Funnel decisions retain their original results. There is no cross-feature result synchronization.
 
 For Customer-based evaluation, `id` means the Longplay Customer UUID (`customer.id`); `externalUserId` means the merchant account ID (`customer.externalUserId`). Choose the experiment's `hashAttribute` explicitly when creating it and preserve that meaning in every consumer. Do not put the merchant account ID into `attributes.id`. Supply local attributes from your trusted backend's Customer data; `identify(customerToken)` authenticates requests but does not populate local bucketing attributes. These attributes are evaluation data, not authorization.
 
-`setAttributes()` replaces the complete object, so retain the bucketing fields on every update. Anonymous page/visual experiments instead default `id` and `deviceId` to the shared first-party device cookie; they do not automatically match an account-based experiment. Sticky capabilities differ by adapter: managed Local Run instructions receive server state, while pure local tools require their existing host persistence adapter for durable Sticky. No new shared state is introduced. See the [architecture boundary](../../docs/growthbook-sdk-delivery.md#跨消费方求值边界与分桶身份).
+`setAttributes()` replaces the complete object, so retain the bucketing fields on every update. Anonymous page/visual experiments instead default `id` and `deviceId` to the shared first-party device cookie; they do not automatically match an account-based experiment. An open visual client rereads its payload every 60 seconds while visible, so a stopped experiment or disabled delivery reverts without a page reload. Sticky capabilities differ by adapter: managed Local Run instructions receive server state, while pure local tools require their existing host persistence adapter for durable Sticky. No new shared state is introduced. See the [architecture boundary](../../docs/growthbook-sdk-delivery.md#跨消费方求值边界与分桶身份).
 
 ### Server-side local Funnel evaluation
 
@@ -271,6 +305,8 @@ The server implements Customer/Guest identity, Entitlement checks, holdings and
 
 In Stripe environments, Longplay executes `longplay` mode; `record_only` returns instructions for the merchant backend to execute. Both record financial and Entitlement facts from verified Stripe evidence. Collecting a payment method does not itself charge, create an Invoice, or grant extra Entitlements. Quotes, confirmations, and reads retain their durable operation IDs; a request ID cannot be reused with different input.
 
+Customer `claimCoupon`, `redeemCoupon`, `redeemReward` and `createReferralCode` retain their optional request-ID arguments. If a dispatched call fails, `LongplayError.commandRequestId` exposes the original command ID, including an automatically generated ID; `LongplayError.requestId` remains the HTTP trace ID. Retry the same method with that command ID and unchanged input, for example `longplay.claimCoupon(couponId, error.commandRequestId)`. For recovery across app crashes, generate and persist the command ID and input before the first call. The error does not establish whether the command was accepted.
+
 This beta does not certify complete commercial or production operation. Remaining service gaps include:
 
 - Subscription batch processing. Conflict queries and retries have services but still require a matching deployment and business prerequisites.
@@ -394,9 +430,9 @@ await entries.retry();
 entries.destroy();
 ```
 
-The host observes original button behavior, matches unique render/element guards and attempts automatic entries once per pathname visit. GOP selects the Funnel, checks entry publication, suppresses an existing Customer/Funnel Run and enforces the automatic-entry cooldown. The host retains unknown requests in memory; page reload recovery is not included. When a Run is stopped from Console or expires, the host removes its UI and reports `run_ended`, whether the Run reads `closed` or its next command is refused with `FORBIDDEN`; a later trigger can then start again. An IAM binding supplies no Customer credential or business permission.
+The host observes original button behavior, matches unique render/element guards and attempts automatic entries once per pathname visit. GOP selects the Funnel, checks entry publication, suppresses an existing Customer/Funnel Run and enforces the automatic-entry cooldown. With a full Customer Session, the host retains the original entry request and verified source target in tab-scoped `sessionStorage`. On reload it replays that exact request under the same logical Customer Session to recover the same Run, including background Waits and unresolved starts, without another Split allocation. The merchant must restore that session before installing the host, renew it with its Refresh Token, and isolate its credential storage by native account and App/environment. SDK credentials are memory-only by default; use `session.snapshot()` to retain the latest rotated pair and clear it on account/workspace changes or sign-out. Issuing a new session changes the Run credential derived for a replayed start. Records are bound to API origin, App, environment, Customer and IAM release, and contain no Customer or Run credentials. Recovery waits for the original scene and also works when the accepted publication is paused or superseded. A bare-token session has no stable Customer binding and remains memory-only. Set `recoveryStorage: false` to disable persistence, or supply a `Storage` adapter; unavailable storage reports `recovery_unavailable`. When the page unloads, the host is destroyed or the Customer changes while a screen is shown, the host closes that Run (with `keepalive` on unload), so a later entry is not suppressed until the Run expires; Paywall, in-flight and background steps continue. When a Run is stopped from Console or expires, the host removes its UI and reports `run_ended`, whether the Run reads `closed` or its next command is refused with `FORBIDDEN`; a later trigger can then start again. An IAM binding supplies no Customer credential or business permission.
 
-The entry scope is the route template plus render, covering every matching dynamic URL instance. Query/hash changes do not create a new visit. Supported anchor and inline-display changes recheck delayed scenes; hidden retained pages do not block the single active button. The clicked control itself must still be the unique active target; a replacement with the same selector cannot authorize an obsolete click. Multiple active targets remain refused. Configuration fetch/body reads default to a five-second deadline (`timeoutMs` overrides it), recover on the next 15-second poll, and discard late responses. Inspect `onStatus` for `identity_required`, `configuration_unavailable`, `incompatible` and `start_failed`. Definitively refused entries and accepted Runs whose first read is refused with a revoked credential allow the next matching entry in delivered order; transient read failures and pending unknown starts retain the original request for `retry()`. Other entries are preserved while a Run is mounted and reconsidered when it ends. Original button navigation continues, so full-page navigation can prevent presentation.
+The entry scope is the route template plus render, covering every matching dynamic URL instance. Query/hash changes do not create a new visit. Supported anchor and inline-display changes recheck delayed scenes; hidden retained pages do not block the single active button. The clicked control itself must still be the unique active target; a replacement with the same selector cannot authorize an obsolete click. Multiple active targets remain refused. Configuration fetch/body reads default to a five-second deadline (`timeoutMs` overrides it), recover on the next 15-second poll, and discard late responses. Inspect `onStatus` for `identity_required`, `configuration_unavailable`, `incompatible` and `start_failed`. Definitively refused entries and accepted Runs whose first read is refused with a revoked credential allow the next matching entry in delivered order; transient read failures and pending unknown starts retain the original request for `retry()`. Automatic entries present at most once per pathname visit: entries matched while a Run is shown, or after it ends, wait for the next visit, so dismissal or completion never chains another Funnel. Explicit button clicks still start. A Run that is paused or waiting on a timer/event step stays hidden, reports `run_background` and no longer blocks other entries; it shows again when it has a screen and yields its slot when another Run mounts. Original button navigation continues, so full-page navigation can prevent presentation.
 
 An opted-in Split (`applyPageExperiment: true`) uses its accepted experiment variation for the merchant page. The entry host automatically shares `appManifestRelease` with `showFunnelRun`; manual hosts pass that option explicitly. `createFunnelPageExperiments({client, appManifestRelease})` is available for hosts without the standard UI. The consumer never rebuckets, reports use against the accepted receipt, and reverts on stop, completion or destruction. A separately installed visual consumer yields ownership of that experiment during the Run. This Web source feature requires matching GOP contracts and the IAM/Funnel database migration; installation alone does not promote runtime support.
 

package/README.zh-CN.md

@@ -191,7 +191,7 @@ Funnel、独立 Feature 和页面实验各自求值、各自使用结果。App
 
 Customer 求值中的 `id` 是 Longplay Customer UUID（`customer.id`），`externalUserId` 是商户账号 ID（`customer.externalUserId`）。创建实验时明确选择 `hashAttribute`，每个消费方保持相同语义；不要把商户账号 ID 填进 `attributes.id`。本地属性来自可信后端给当前用户的 Customer 数据；`identify(customerToken)` 负责请求认证，不会自动补齐本地分桶属性。属性仅用于求值，不构成授权。
 
-`setAttributes()` 替换整个对象，每次更新都保留分桶字段。匿名页面／视觉实验默认的 `id` 和 `deviceId` 来自共用的第一方设备 cookie，不自动与账号实验同组。各适配器的 Sticky 能力有区别：共用 Run 的 Local 指令读取服务端状态，纯本地工具的持久 Sticky 使用已有宿主适配器，不新增共享状态。完整要求见[架构边界](../../docs/growthbook-sdk-delivery.md#跨消费方求值边界与分桶身份)。
+`setAttributes()` 替换整个对象，每次更新都保留分桶字段。匿名页面／视觉实验默认的 `id` 和 `deviceId` 来自共用的第一方设备 cookie，不自动与账号实验同组。已打开的页面在可见时每 60 秒重新读取视觉配置，实验停止或关闭投放后无需刷新页面即可撤销修改。各适配器的 Sticky 能力有区别：共用 Run 的 Local 指令读取服务端状态，纯本地工具的持久 Sticky 使用已有宿主适配器，不新增共享状态。完整要求见[架构边界](../../docs/growthbook-sdk-delivery.md#跨消费方求值边界与分桶身份)。
 
 ### 服务端 SDK 本地 Funnel 求值
 
@@ -273,6 +273,8 @@ Stripe 环境的 `longplay` 模式由 Longplay 执行；`record_only` 返回交
 
 已实现商业能力在 Sandbox 与 Live 均沿用原凭据、权限、作用域和真实 Provider 配置检查。未实现操作返回 501；缺少配置或业务前置条件不等于迁移期白名单。
 
+Customer 的 `claimCoupon`、`redeemCoupon`、`redeemReward` 和 `createReferralCode` 保留可选 requestId 参数。请求发出后失败时，`LongplayError.commandRequestId` 提供原命令 ID，包含 SDK 自动生成的 ID；原有 `LongplayError.requestId` 仍是 HTTP 追踪 ID。用该命令 ID 和不变的输入调用同一方法重试，例如 `longplay.claimCoupon(couponId, error.commandRequestId)`。需要跨崩溃恢复时，应在首次调用前生成并持久保存 ID 与输入。错误本身不能证明命令是否已被接受。
+
 ## AI 用量
 
 `/server` 提供 AI SDK 用量中间件；`/openrouter` 提供 OpenRouter 包装器。宿主必须提供每次调用的持久幂等键、usage／quote 存储及恢复回调。恢复时重放原报价的扣款，不重新运行模型。密钥始终留在可信后端。
@@ -305,7 +307,7 @@ npm 发布不部署 Web 服务、不应用数据库迁移，也不发布 Swift
 
 `createIamFunnelEntries({scope, environmentId, baseUrl, appManifestRelease, session: longplay.session, container})` 安装一次后，通过 `start()` 启动监听，即可在 IAM 页面地图配置现有 Funnel Entry 节点的「进入屏幕」和「按钮/链接点击」入口。配置保存到 Funnel 草稿，随 Funnel 一起发布、暂停。`appManifestRelease` 必须来自当前构建的 IAM release descriptor。描述文件的请求头和正文读取共用两秒超时，fetch 忽略取消时也会释放等待。原页面点击处理继续执行；点击的原节点本身必须仍是唯一活动目标，具有相同选择器的替代节点不能证明旧点击有效。自动入口每次 pathname 访问尝试一次，查询参数、hash 和重新渲染不制造新访问。
 
-服务端选择 Funnel，验证发布状态，并按原 Customer/Funnel 检查进行中的 Run 和自动入口冷却时间。未知响应或 Run 首次读取的暂时失败通过 `retry()` 复用内存中的原请求；入口宿主不提供刷新页面后的恢复。已接受 Run 在首次读取或离开页面后的关闭请求中被撤销凭据拒绝时，会释放入口等待。Run 被 Console 终止或过期后，无论读取到 `closed` 状态还是后续命令被 `FORBIDDEN` 拒绝，入口宿主都会移除界面并上报 `run_ended`，之后的入口可以重新启动。卸载时调用 `destroy()`。IAM 不提供 Customer 凭据或业务权限。
+服务端选择 Funnel，验证发布状态，并按原 Customer/Funnel 检查进行中的 Run 和自动入口冷却时间。未知响应或 Run 首次读取的暂时失败通过 `retry()` 复用内存中的原请求；完整 Customer Session 下，入口宿主将原 `entry_start` 请求及已验证目标保存到当前标签页的 `sessionStorage`，按 API origin、App、环境、Customer 和 IAM release 隔离，不保存 Customer 或 Run 凭据。刷新后回到原场景时，以当前 Customer 凭据重放同一请求，恢复原 Run、后台 Wait 和未知启动结果，不重新分组；原发布已暂停或换版也可恢复。裸 Token 会话仍仅保留内存状态；`recoveryStorage: false` 可关闭持久化，或传入 `Storage` 适配器；存储不可用时报告 `recovery_unavailable`。页面卸载、宿主销毁或 Customer 切换时，若正在展示普通屏幕，宿主会关闭该 Run（页面卸载时使用 `keepalive`），避免之后的入口在 Run 过期前一直被判为进行中。Paywall、进行中的请求和后台步骤不受影响。已接受 Run 在首次读取或离开页面后的关闭请求中被撤销凭据拒绝时，会释放入口等待。Run 被 Console 终止或过期后，无论读取到 `closed` 状态还是后续命令被 `FORBIDDEN` 拒绝，入口宿主都会移除界面并上报 `run_ended`，之后的入口可以重新启动。自动入口每次 pathname 访问最多展示一次：某个 Run 正在展示或已经展示后，同一访问内匹配的其他自动入口留到下一次访问，关闭或完成不会接着弹出另一个 Funnel；用户明确点击按钮仍可启动。Funnel 暂停或 Run 停在定时／事件等待步骤时，界面隐藏并上报 `run_background`，不再阻挡其他入口；之后有画面会重新显示，另一个 Run 挂载时让出位置。卸载时调用 `destroy()`。IAM 不提供 Customer 凭据或业务权限。
 
 Split 开启 `applyPageExperiment` 后，页面直接使用该 Run 已接受的实验变体，不重新分桶。标准入口宿主自动向 `showFunnelRun` 传入 release；手动宿主传入 `appManifestRelease`，或使用 `createFunnelPageExperiments({client, appManifestRelease})`。停止、完成和销毁会清理效果，实际应用沿用原 receipt 的 GB used 上报。同一实验的独立 visual consumer 在 Funnel 持有分组期间让出控制。这些 Web 源码能力需要配套 GOP 合同和数据库迁移，安装 SDK 不等于运行时已发布。
 

package/dist/{ai-usage-Btwg1nD7.d.ts → ai-usage-C-OZBxgW.d.ts}

@@ -1,5 +1,5 @@
 import { LanguageModelV4Usage, LanguageModelV4Middleware } from '@ai-sdk/provider';
-import { F as FoundationApi, A as ApiInput } from './api-5gAz4-Sb.js';
+import { F as FoundationApi, A as ApiInput } from './api-Bf_aRlXs.js';
 import { z } from 'zod';
 
 declare const tokenCounts: z.ZodObject<{

package/dist/{api-5gAz4-Sb.d.ts → api-Bf_aRlXs.d.ts}

@@ -5485,6 +5485,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -5565,6 +5568,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -5643,6 +5649,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -5696,6 +5705,9 @@ declare const apiOperations: {
                         IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                         RESULT_UNKNOWN: "RESULT_UNKNOWN";
                         STATE_CHANGED: "STATE_CHANGED";
+                        IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                        CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                        RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                         OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                         FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                     }>>;
@@ -6664,6 +6676,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -6744,6 +6759,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -6822,6 +6840,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -6875,6 +6896,9 @@ declare const apiOperations: {
                         IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                         RESULT_UNKNOWN: "RESULT_UNKNOWN";
                         STATE_CHANGED: "STATE_CHANGED";
+                        IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                        CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                        RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                         OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                         FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                     }>>;
@@ -7698,6 +7722,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -7778,6 +7805,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -7856,6 +7886,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -7909,6 +7942,9 @@ declare const apiOperations: {
                         IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                         RESULT_UNKNOWN: "RESULT_UNKNOWN";
                         STATE_CHANGED: "STATE_CHANGED";
+                        IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                        CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                        RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                         OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                         FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                     }>>;
@@ -8706,6 +8742,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -8786,6 +8825,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -8864,6 +8906,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -8917,6 +8962,9 @@ declare const apiOperations: {
                         IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                         RESULT_UNKNOWN: "RESULT_UNKNOWN";
                         STATE_CHANGED: "STATE_CHANGED";
+                        IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                        CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                        RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                         OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                         FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                     }>>;
@@ -9848,6 +9896,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -9928,6 +9979,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -10006,6 +10060,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -10059,6 +10116,9 @@ declare const apiOperations: {
                         IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                         RESULT_UNKNOWN: "RESULT_UNKNOWN";
                         STATE_CHANGED: "STATE_CHANGED";
+                        IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                        CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                        RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                         OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                         FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                     }>>;
@@ -10551,6 +10611,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -10631,6 +10694,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -10709,6 +10775,9 @@ declare const apiOperations: {
                             IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                             RESULT_UNKNOWN: "RESULT_UNKNOWN";
                             STATE_CHANGED: "STATE_CHANGED";
+                            IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                            CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                            RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                             OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                             FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                         }>>;
@@ -10762,6 +10831,9 @@ declare const apiOperations: {
                         IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT";
                         RESULT_UNKNOWN: "RESULT_UNKNOWN";
                         STATE_CHANGED: "STATE_CHANGED";
+                        IDENTITY_CONTEXT_CHANGED: "IDENTITY_CONTEXT_CHANGED";
+                        CUSTOMER_BINDING_CONFLICT: "CUSTOMER_BINDING_CONFLICT";
+                        RUN_CONTRACT_MISMATCH: "RUN_CONTRACT_MISMATCH";
                         OPERATION_IN_PROGRESS: "OPERATION_IN_PROGRESS";
                         FUNNEL_VERSION_RETIRED: "FUNNEL_VERSION_RETIRED";
                     }>>;
@@ -13565,6 +13637,11 @@ declare const apiOperations: {
             }, z$1.core.$strict>>;
             funnelId: z$1.ZodOptional<z$1.ZodUUID>;
             funnelVersionId: z$1.ZodOptional<z$1.ZodUUID>;
+            processContext: z$1.ZodOptional<z$1.ZodObject<{
+                runId: z$1.ZodUUID;
+                bindingId: z$1.ZodUUID;
+                receiptId: z$1.ZodUUID;
+            }, z$1.core.$strict>>;
         }, z$1.core.$strict>;
         readonly response: z$1.ZodObject<{
             requestId: z$1.ZodUUID;
@@ -14092,6 +14169,11 @@ declare const apiOperations: {
             }, z$1.core.$strict>>;
             funnelId: z$1.ZodOptional<z$1.ZodUUID>;
             funnelVersionId: z$1.ZodOptional<z$1.ZodUUID>;
+            processContext: z$1.ZodOptional<z$1.ZodObject<{
+                runId: z$1.ZodUUID;
+                bindingId: z$1.ZodUUID;
+                receiptId: z$1.ZodUUID;
+            }, z$1.core.$strict>>;
         }, z$1.core.$strict>;
         readonly response: z$1.ZodObject<{
             requestId: z$1.ZodUUID;