@genesislcap/ai-assistant 15.60.0 → 15.62.0

package/dist/dts/react.d.ts

@@ -4,6 +4,7 @@
  */
 
 import type React from 'react';
+import type { AutopilotHandBack as AutopilotHandBackWC } from './autopilot/hand-back/hand-back';
 import type { AiActivityHalo as AiActivityHaloWC } from './components/activity-halo/activity-halo';
 import type { AgentPicker as AgentPickerWC } from './components/agent-picker/agent-picker';
 import type { AiChatBubble as AiChatBubbleWC } from './components/chat-bubble/chat-bubble';
@@ -106,6 +107,15 @@ export declare const ChatSuggestions: React.ForwardRefExoticComponent<
 >;
 export type ChatSuggestionsRef = ChatSuggestionsWC;
 
+export declare const AutopilotHandBack: React.ForwardRefExoticComponent<
+  React.PropsWithChildren<
+    Omit<PublicOf<AutopilotHandBackWC>, 'children' | 'style'> &
+    HTMLWCProps & {
+    }
+  > & React.RefAttributes<AutopilotHandBackWC>
+>;
+export type AutopilotHandBackRef = AutopilotHandBackWC;
+
 export declare const AiActivityHalo: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
     Omit<PublicOf<AiActivityHaloWC>, 'children' | 'style'> &

package/dist/dts/state/debug-event-log.d.ts

@@ -28,7 +28,7 @@ import type { TurnFailureReason } from '@genesislcap/foundation-ai';
  * Catalogue of meta event names. This is the documented surface — extend it as
  * new events are wired in (Tier 2/3 lifecycle, interaction, provider events).
  */
-export type MetaEventType = 'assistant.connected' | 'assistant.disconnected' | 'assistant.popout' | 'assistant.popin' | 'driver.created' | 'driver.wired' | 'driver.unwired' | 'state.changed' | 'turn.start' | 'turn.end' | 'turn.retry' | 'turn.error' | 'tool.failed' | 'tool.unresolved' | 'subagent.started' | 'subagent.completed' | 'subagent.failed' | 'routing.decided' | 'agent.handoff' | 'agent.pinned' | 'agent.unpinned' | 'provider.selected' | 'interaction.requested' | 'interaction.resolved' | 'interaction.external-cost' | 'interaction.external-cost-dropped' | 'interaction.outcome' | 'interaction.outcome-dropped' | 'interaction.held' | 'interaction.claim-refused' | 'external-diagnostics.folded' | 'context.updated' | 'context.threshold-crossed' | 'context.compacted' | 'context.condensed' | 'panel.toggled' | 'attachment.added' | 'file.read-failed' | 'suggestions.failed' | 'session.cleared' | 'session.switched' | 'session.switch-deferred' | 'persistence.toggled' | 'persistence.saved' | 'persistence.save-failed' | 'persistence.suppressed' | 'persistence.not-resumable' | 'persistence.restored' | 'persistence.resume-planned' | 'persistence.resume-withdrawn' | 'persistence.restore-orphan';
+export type MetaEventType = 'assistant.connected' | 'assistant.disconnected' | 'assistant.popout' | 'assistant.popin' | 'driver.created' | 'driver.wired' | 'driver.unwired' | 'state.changed' | 'turn.start' | 'turn.end' | 'turn.retry' | 'turn.error' | 'tool.failed' | 'tool.unresolved' | 'subagent.started' | 'subagent.completed' | 'subagent.failed' | 'routing.decided' | 'agent.handoff' | 'agent.pinned' | 'agent.unpinned' | 'provider.selected' | 'interaction.requested' | 'interaction.resolved' | 'interaction.external-cost' | 'interaction.external-cost-dropped' | 'interaction.outcome' | 'interaction.outcome-dropped' | 'interaction.step' | 'interaction.checkpoint' | 'interaction.held' | 'interaction.claim-refused' | 'interaction.invoked' | 'autopilot.claimed' | 'autopilot.declined' | 'autopilot.decision-sent' | 'autopilot.acted' | 'autopilot.handed-back' | 'autopilot.paused' | 'autopilot.resumed' | 'autopilot.error' | 'autopilot.refinement' | 'autopilot.handback-presented' | 'autopilot.catch-up' | 'autopilot.cost-dropped' | 'external-diagnostics.folded' | 'context.updated' | 'context.threshold-crossed' | 'context.compacted' | 'context.condensed' | 'panel.toggled' | 'attachment.added' | 'file.read-failed' | 'suggestions.failed' | 'session.cleared' | 'session.switched' | 'session.switch-deferred' | 'persistence.toggled' | 'persistence.saved' | 'persistence.save-failed' | 'persistence.suppressed' | 'persistence.not-resumable' | 'persistence.restored' | 'persistence.resume-planned' | 'persistence.resume-withdrawn' | 'persistence.restore-orphan';
 /**
  * How much a reader should care about an event — lets a consumer (or an AI
  * agent) filter the timeline: skip `low` UI/bookkeeping noise, skim `normal`

package/dist/dts/state/debug-event-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debug-event-log.d.ts","sourceRoot":"","sources":["../../../src/state/debug-event-log.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"debug-event-log.d.ts","sourceRoot":"","sources":["../../../src/state/debug-event-log.ts"],"names":[],"mappings":"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"}

package/dist/dts/state/decision-surface.d.ts

@@ -0,0 +1,46 @@
+import type { DecisionSpec, InteractionSurface, SurfaceSpec } from '../types/interaction-surface';
+/** The `select` action a multi-select adds. Platform-owned, so never an option's id. */
+export declare const SELECT_ACTION = "select";
+/** The `reply` action `freeText` adds. Platform-owned, so never an option's id. */
+export declare const REPLY_ACTION = "reply";
+/** Why an action could not run, before anything ran. */
+export interface ActionRefusal {
+    readonly error: 'unknown-action' | 'disabled' | 'invalid-args';
+    readonly message: string;
+}
+/** An action ready to run: what to call, and how to describe the choice to the asking tool. */
+export interface PreparedAction {
+    /** The choice as text, for `decidedOnUsersBehalf`: an option's label, the labels picked, or the reply. */
+    readonly choice: string;
+    /** Whether it is a finishing action: only one that finishes can be an answer. */
+    readonly finishes: boolean;
+    /** Runs it. An editing action may return what changed, which the claimant is shown. */
+    readonly run: () => unknown | Promise<unknown>;
+}
+/** A decision surface: what anyone may read, plus how the platform runs an action on it. */
+export interface DecisionSurface extends InteractionSurface {
+    /** Check `name` and `args` against the surface as it stands now, without running anything. */
+    prepare(name: string, args: unknown): PreparedAction | ActionRefusal;
+}
+/**
+ * Build the surface for a short-form decision (GENC-1660). Its actions are its options (by id),
+ * plus `select` for a multi-select and `reply` for a written answer; all of them finish. Every
+ * read — facts, actions, enabled-ness — is taken fresh, so the surface always describes the
+ * widget as it is now.
+ *
+ * Throws if an option's id collides with another or with a platform-owned name, which is a bug in
+ * the widget rather than something to recover from.
+ */
+export declare function buildDecisionSurface(spec: DecisionSpec): DecisionSurface;
+/**
+ * Check `args` against an action's schema: an object, with its `required` properties present and
+ * each listed property of its declared top-level `type`. Deliberately shallow — enough to refuse a
+ * malformed call with a reason the model can act on, without a schema library in the browser.
+ */
+export declare function checkArgs(args: unknown, schema: Readonly<Record<string, unknown>> | undefined): string | undefined;
+/**
+ * Build the surface for a full-form spec (GENC-1660 §4.2): named actions, some editing and some
+ * finishing, each guarded and schema-checked; a description; views to read. Every read is fresh.
+ */
+export declare function buildFullSurface(spec: SurfaceSpec): DecisionSurface;
+//# sourceMappingURL=decision-surface.d.ts.map

package/dist/dts/state/decision-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-surface.d.ts","sourceRoot":"","sources":["../../../src/state/decision-surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EACZ,kBAAkB,EAElB,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAEtC,wFAAwF;AACxF,eAAO,MAAM,aAAa,WAAW,CAAC;AACtC,mFAAmF;AACnF,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,GAAG,cAAc,CAAC;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,0GAA0G;IAC1G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,uFAAuF;IACvF,QAAQ,CAAC,GAAG,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED,4FAA4F;AAC5F,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,8FAA8F;IAC9F,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,aAAa,CAAC;CACtE;AAsBD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,CA+FxE;AAwBD;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GACpD,MAAM,GAAG,SAAS,CAYpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,CA4CnE"}

package/dist/dts/state/interaction-context.d.ts

@@ -1,4 +1,5 @@
 import type { InteractionContext, InteractionHolder } from '../types/interaction-context';
+import { type DecisionSurface } from './decision-surface';
 /**
  * A created {@link InteractionContext} plus the host-only `dispose` handle. The
  * driver keeps the handle (so it can tear the context down on resolve/evict) and
@@ -20,6 +21,25 @@ export interface InteractionContextHandle {
      * returns `false` once the context is disposed, or when the holder is unchanged.
      */
     setHeldBy(holder: InteractionHolder): boolean;
+    /** Install the controller the platform built from the widget's registration (GENC-1660). */
+    setController(controller: unknown): void;
+    /**
+     * The surface with the platform's half — `prepare`, which checks and readies an action without
+     * running it. Host-only: a claimant runs actions through its `InteractionHold`, never directly.
+     */
+    readonly surface: DecisionSurface | undefined;
+}
+/** What the driver lends a context so it can settle itself. */
+export interface InteractionContextDeps {
+    /**
+     * Settle the interaction, through the same path as a widget's `interaction-completed` (GENC-1660).
+     * Absent where nothing can settle it (a context built on its own in a test).
+     */
+    resolve?(result: unknown): void;
+    /** A checkpoint the platform handed over from work a reload cut (GENC-1660 §4.12). */
+    readonly checkpoint?: unknown;
+    /** Persist a checkpoint. Absent where nothing persists it (a context built on its own in a test). */
+    saveCheckpoint?(checkpoint: unknown): void;
 }
 /**
  * Create a live, per-interaction context (GENC-1390). Framework-agnostic: the
@@ -28,5 +48,5 @@ export interface InteractionContextHandle {
  *
  * @internal
  */
-export declare function createInteractionContext(interactionId: string): InteractionContextHandle;
+export declare function createInteractionContext(interactionId: string, deps?: InteractionContextDeps): InteractionContextHandle;
 //# sourceMappingURL=interaction-context.d.ts.map

package/dist/dts/state/interaction-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interaction-context.d.ts","sourceRoot":"","sources":["../../../src/state/interaction-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAG1F;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;CAC/C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,wBAAwB,CAmFxF"}
+{"version":3,"file":"interaction-context.d.ts","sourceRoot":"","sources":["../../../src/state/interaction-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAE1F,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAElG;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAC9C,4FAA4F;IAC5F,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAC;CAC/C;AAED,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,qGAAqG;IACrG,cAAc,CAAC,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE,sBAA2B,GAChC,wBAAwB,CAiK1B"}

package/dist/dts/state/interaction-registry.d.ts

@@ -0,0 +1,63 @@
+import type { InteractionContext } from '../types/interaction-context';
+/**
+ * Builds a widget's controller when its interaction is requested (GENC-1660). DOM-free: it owns the
+ * interaction's state, its surface and resolving it; the view only renders.
+ *
+ * @beta
+ */
+export type InteractionControllerFactory = (data: unknown, ctx: InteractionContext) => unknown;
+/**
+ * How a widget is registered with the platform, once, at start-up (GENC-1660).
+ *
+ * @beta
+ */
+export interface InteractionRegistration {
+    /**
+     * Builds the controller when the interaction is requested, before anything renders. Without
+     * one the widget works exactly as today and is never handed to a claimant.
+     */
+    readonly controller?: InteractionControllerFactory;
+    /** The custom element that renders it. Defaults to the registered name. */
+    readonly view?: string;
+    /**
+     * What the widget shows while a claimant holds it: `'visible'` (the default; it hides only the
+     * buttons the claimant owns) or `'hidden'` (the wrapper drops the bubble chrome too).
+     */
+    readonly whileAutopilot?: 'visible' | 'hidden';
+    /**
+     * The widget as text: what the person saw. Without `result` the pending widget, with it what the
+     * resolved view shows. Used for the visible transcript a claimant reads.
+     */
+    readonly asText?: (data: unknown, result?: unknown) => string;
+    /**
+     * Whether a checkpoint a reload cut (`saved`) is the same work as this new request (`next`, its
+     * data), so the new interaction may take it over and skip what is already done (GENC-1660 §4.12).
+     * Without it, the same widget type is enough. Compare identity only — the fields the work's
+     * output depends on, kept in the checkpoint itself — never the model's prose, which a resumed call
+     * rewrites.
+     */
+    readonly sameWork?: (saved: unknown, next: unknown) => boolean;
+}
+/**
+ * Register a widget with the platform (GENC-1660): its controller, the element that renders it, how
+ * it behaves while a claimant holds it, and its text form. Once per name, at start-up; a second
+ * registration under the same name replaces the first, with a warning.
+ *
+ * Registering is optional and additive: an unregistered widget works exactly as before.
+ *
+ * @beta
+ */
+export declare function registerInteraction(name: string, registration: InteractionRegistration): void;
+/**
+ * The registration for a component name, or `undefined` when it has none.
+ *
+ * @beta
+ */
+export declare function getInteractionRegistration(name: string): InteractionRegistration | undefined;
+/**
+ * Forget every registration. For tests.
+ *
+ * @internal
+ */
+export declare function clearInteractionRegistry(): void;
+//# sourceMappingURL=interaction-registry.d.ts.map

package/dist/dts/state/interaction-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-registry.d.ts","sourceRoot":"","sources":["../../../src/state/interaction-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC;AAE/F;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,4BAA4B,CAAC;IACnD,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;IAC9D;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;CAChE;AAID;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAK7F;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/dts/state/persistence/session-persister.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-persister.d.ts","sourceRoot":"","sources":["../../../../src/state/persistence/session-persister.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-persister.d.ts","sourceRoot":"","sources":["../../../../src/state/persistence/session-persister.ts"],"names":[],"mappings":"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"}

package/dist/dts/state/persistence/session-snapshot.d.ts

@@ -64,6 +64,25 @@ export interface PersistedSession {
      * predates it ignores it. Omitted rather than written empty when there is nothing to carry.
      */
     condensePolicies?: PersistedCondensePolicy[];
+    /**
+     * The autopilot's mode for the flow it was set for (GENC-1660 §4.8), restored with the session.
+     * Optional and additive like `condensePolicies`: absent when no autopilot was switched for the
+     * current flow, and a snapshot from before it existed restores with the autopilot paused.
+     */
+    autopilot?: {
+        onFor: string;
+        mode: 'running' | 'paused';
+    };
+    /**
+     * The checkpoint of a long action (GENC-1660 §4.12): what a widget's work had already done, so a
+     * reload skips it. Kept here rather than on the interaction message, which a restore trims. On
+     * restore it waits for the first request of the same widget type. Optional and additive, like
+     * `condensePolicies`.
+     */
+    checkpoint?: {
+        componentName: string;
+        value: unknown;
+    };
     /**
      * Interrupted-flow marker (GENC-1351 §5.9). Present when the session was saved
      * while an agent declared its current state non-resumable (`resumable === false`).
@@ -100,6 +119,8 @@ export interface PersistedSessionInput {
     activeProviderName?: string;
     agentSnapshots?: Record<string, unknown>;
     condensePolicies?: PersistedCondensePolicy[];
+    autopilot?: PersistedSession['autopilot'];
+    checkpoint?: PersistedSession['checkpoint'];
 }
 /**
  * Assemble a versioned {@link PersistedSession}, stamping `version` and

package/dist/dts/state/persistence/session-snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/state/persistence/session-snapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/state/persistence/session-snapshot.ts"],"names":[],"mappings":"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"}

package/dist/dts/state/run-steps.d.ts

@@ -0,0 +1,66 @@
+import type { InteractionContext } from '../types/interaction-context';
+/**
+ * A long action's checkpoint (GENC-1660 §4.12): the steps already done, the steps that started, and
+ * whatever the steps returned or saved. Keep it small, and storable as JSON.
+ *
+ * @beta
+ */
+export type StepCheckpoint = {
+    /** Steps that finished: skipped when the work resumes after a reload. */
+    readonly done: readonly string[];
+    /** Steps that started. One started but not done was cut mid-way, and runs again. */
+    readonly started?: readonly string[];
+} & Record<string, unknown>;
+/**
+ * One named step of a long action. A step is either done-or-restart (its output is kept once it
+ * finishes, and a cut one simply runs again) or re-attachable (it saves a job id with `save` before
+ * waiting, and on a re-run finds that id in the checkpoint and reconnects to the job).
+ *
+ * @beta
+ */
+export interface Step<C extends StepCheckpoint> {
+    readonly name: string;
+    /**
+     * Do the step. Returns its outputs, merged into the checkpoint. `save` persists part of an
+     * unfinished step, such as a job id, before a long wait.
+     */
+    run(checkpoint: C, io: {
+        readonly signal?: AbortSignal;
+        save(partial: Partial<C>): void;
+    }): Promise<Partial<C>>;
+}
+/**
+ * How a step went, for the debug log.
+ *
+ * @beta
+ */
+export type StepOutcome = 'started' | 'resumed' | 'done' | 'skipped';
+type StepRecorder = (step: string, outcome: StepOutcome) => void;
+/** Records a handed-over checkpoint that `runSteps` could not use, and why. */
+type CheckpointRefusalRecorder = (reason: string, saved: unknown) => void;
+/**
+ * Bind the debug-log recorders for a context's steps: each step's outcome, and a handed-over
+ * checkpoint refused as malformed. Called by the platform when it creates the context, so
+ * `runSteps` records under the right session without the context carrying it.
+ *
+ * @internal
+ */
+export declare function bindStepRecorder(ctx: object, record: StepRecorder, refused?: CheckpointRefusalRecorder): void;
+/**
+ * Run a long action as named steps, checkpointing after each one (GENC-1660 §4.12), so a reload
+ * skips what is already done instead of starting again.
+ *
+ * Starts from the checkpoint the platform handed over, if any — it has already decided, by widget
+ * type and the registration's `sameWork`, that the checkpoint is this work's — or from `initial`, the
+ * identity `sameWork` compares, kept in the checkpoint because the request that cut it is gone.
+ * Each step that is already done is skipped; the rest run in order. `ctx.state.stage` names the step
+ * running, and every step notifies, which is also the watchdog's heartbeat.
+ *
+ * Exported beside the context rather than added to it, so the context's own API stays small.
+ * Throws if `signal` aborts, before or between steps.
+ *
+ * @beta
+ */
+export declare function runSteps<C extends StepCheckpoint>(ctx: InteractionContext<object, C>, initial: Omit<C, 'done' | 'started'>, steps: readonly Step<C>[], signal?: AbortSignal): Promise<C>;
+export {};
+//# sourceMappingURL=run-steps.d.ts.map

package/dist/dts/state/run-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-steps.d.ts","sourceRoot":"","sources":["../../../src/state/run-steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,SAAS,cAAc;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,GAAG,CACD,UAAU,EAAE,CAAC,EACb,EAAE,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;KAAE,GACrE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAErE,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;AAEjE,+EAA+E;AAC/E,KAAK,yBAAyB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAS1E;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,yBAAyB,GAClC,IAAI,CAEN;AAuBD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,QAAQ,CAAC,CAAC,SAAS,cAAc,EACrD,GAAG,EAAE,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC,EAClC,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,EACpC,KAAK,EAAE,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC,CA4BZ"}

package/dist/dts/types/ai-chat-widget.d.ts

@@ -1,4 +1,4 @@
-import type { InteractionResult } from '@genesislcap/foundation-ai';
+import type { InteractionEdit, InteractionResult } from '@genesislcap/foundation-ai';
 import type { InteractionContext } from './interaction-context';
 /**
  * The two mutually-exclusive states an interaction widget is ever in (GENC-1390).
@@ -38,6 +38,12 @@ export type AiChatInteraction<TData = unknown, TResult = unknown> = {
      * Display-only: the widget shows it, and it is never sent to a model.
      */
     outcome?: unknown;
+    /**
+     * The edits a claimant (an autopilot, say) made to the widget before it was settled, in
+     * order, whoever settled it. Absent when there were none. Lets the resolved view mark what
+     * was changed for the person rather than by them; display-only.
+     */
+    edits?: readonly InteractionEdit[];
 };
 /**
  * Interface that AI inline interaction components implement. The

package/dist/dts/types/ai-chat-widget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-chat-widget.d.ts","sourceRoot":"","sources":["../../../src/types/ai-chat-widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAC5D;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,4CAA4C;IAC5C,IAAI,EAAE,KAAK,CAAC;IACZ;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,kBAAkB,EAAE,kBAAkB,CAAC;CACxC,GACD;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,wDAAwD;IACxD,IAAI,EAAE,KAAK,CAAC;IACZ,+BAA+B;IAC/B,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACnC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC9D,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IAEtB,2DAA2D;IAC3D,WAAW,EAAE,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;CAChD"}
+{"version":3,"file":"ai-chat-widget.d.ts","sourceRoot":"","sources":["../../../src/types/ai-chat-widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAC5D;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,4CAA4C;IAC5C,IAAI,EAAE,KAAK,CAAC;IACZ;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,kBAAkB,EAAE,kBAAkB,CAAC;CACxC,GACD;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,wDAAwD;IACxD,IAAI,EAAE,KAAK,CAAC;IACZ,+BAA+B;IAC/B,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACnC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACpC,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC9D,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IAEtB,2DAA2D;IAC3D,WAAW,EAAE,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;CAChD"}

package/dist/dts/types/interaction-context.d.ts

@@ -1,3 +1,4 @@
+import type { DecisionSpec, InteractionSurface, SurfaceSpec } from './interaction-surface';
 /**
  * Who holds a pending interaction: the person, or the id of the interceptor that claimed it
  * (GENC-1660). See {@link InteractionContext.heldBy}.
@@ -5,6 +6,16 @@
  * @beta
  */
 export type InteractionHolder = 'user' | (string & {});
+/**
+ * A long action's checkpoint as persisted with the session (GENC-1660 §4.12): the widget type it
+ * belongs to, and the value its controller saved.
+ *
+ * @beta
+ */
+export interface PersistedInteractionCheckpoint {
+    readonly componentName: string;
+    readonly value: unknown;
+}
 /**
  * A live, per-interaction scratch space owned by the chat host (keyed by
  * `interactionId`) and handed to a widget on every (re)mount.
@@ -34,7 +45,7 @@ export type InteractionHolder = 'user' | (string & {});
  *
  * @beta
  */
-export interface InteractionContext<TState extends object = Record<string, unknown>> {
+export interface InteractionContext<TState extends object = Record<string, unknown>, TCheckpoint = unknown> {
     /** Stable id of the interaction this context belongs to. */
     readonly interactionId: string;
     /**
@@ -90,5 +101,59 @@ export interface InteractionContext<TState extends object = Record<string, unkno
      * has already been disposed runs `fn` immediately.
      */
     onDispose(fn: () => void): void;
+    /**
+     * The widget's controller, built by the platform from its registration when the interaction was
+     * requested, before anything rendered. `undefined` for an unregistered widget. One per
+     * interaction for its whole life, so a remounted view picks up the same one.
+     */
+    readonly controller: unknown;
+    /**
+     * Settle the interaction with `result` — the controller's way to resolve, in place of an element
+     * emitting `interaction-completed`, so resolving needs no mounted view. Goes through the same
+     * path, so cost and diagnostics fold in as before. Settles once: later calls do nothing.
+     */
+    resolve(result: unknown): void;
+    /**
+     * Expose what can be decided here (the short form). Called by the controller: in its constructor
+     * for a pure question, or when its gate opens for a widget that works first. Calling again
+     * replaces it.
+     */
+    exposeDecision(decision: DecisionSpec): void;
+    /**
+     * Expose the full form, for a rich widget: a description, views to read, and named actions —
+     * some only edit (and do not settle), some finish. Calling again replaces the surface, as
+     * `exposeDecision` does.
+     */
+    exposeSurface(surface: SurfaceSpec): void;
+    /** The surface the controller exposed, or `undefined` until it exposes one. */
+    readonly surface: InteractionSurface | undefined;
+    /**
+     * Run `fn` once the surface is ready (see `InteractionSurface.isReady`) — or now if
+     * it already is. Readiness is re-checked on every `notify()`, so a gate whose guard turns true
+     * later fires it then. Never runs after the interaction ends. Returns an unsubscribe.
+     */
+    onSurfaceReady(fn: () => void): () => void;
+    /**
+     * Whether a claimant holds the interaction AND `action` is one of its enabled actions right now.
+     * A view hides a button with this, never with `heldBy` alone: a button the controller did not
+     * expose — an error-state Retry, say — is then never hidden, so nothing can strand the journey.
+     */
+    claimantOwns(action: string): boolean;
+    /** When the controller last called `notify()` (or the interaction opened), in epoch ms. A heartbeat. */
+    readonly lastActivityAt: number;
+    /**
+     * What is already done, for long work that should survive a reload: the last checkpoint saved,
+     * or the one the platform handed over — after a restore, the first request for the same widget
+     * type takes over the checkpoint the reload cut, if the registration's `sameWork` agrees.
+     * `undefined` for fresh work. See `runSteps`, which reads and writes it for you.
+     */
+    readonly checkpoint: TCheckpoint | undefined;
+    /**
+     * Save a checkpoint into the session snapshot, so a reload does not lose it. Kept as JSON, so it
+     * must be storable as JSON; keep it small and hold anything large by reference (a job id, a store
+     * key). One per interaction: each save replaces the last. Cleared when the interaction settles,
+     * and when its flow ends.
+     */
+    saveCheckpoint(checkpoint: TCheckpoint): void;
 }
 //# sourceMappingURL=interaction-context.d.ts.map

package/dist/dts/types/interaction-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interaction-context.d.ts","sourceRoot":"","sources":["../../../src/types/interaction-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,kBAAkB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjF,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAEjD;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE5C;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACjC"}
+{"version":3,"file":"interaction-context.d.ts","sourceRoot":"","sources":["../../../src/types/interaction-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,kBAAkB,CACjC,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,WAAW,GAAG,OAAO;IAErB,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAEjD;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE5C;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAOhC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAE/B;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAE7C;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAE1C,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAEjD;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE3C;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAEtC,wGAAwG;IACxG,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAMhC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,SAAS,CAAC;IAE7C;;;;;OAKG;IACH,cAAc,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;CAC/C"}

package/dist/dts/types/interaction-interceptor.d.ts

@@ -1,4 +1,5 @@
 import type { InteractionContext } from './interaction-context';
+import type { InvokeResult } from './interaction-surface';
 /**
  * The handle an interceptor uses to move a pending interaction between the person and itself
  * (GENC-1660): to the person when it hands back or is paused, back to itself when resumed.
@@ -37,14 +38,36 @@ export interface InteractionHold {
      * `heldBy`. Returns `false`, settling nothing, unless this interceptor holds it right now.
      */
     resolve(result: unknown): boolean;
+    /**
+     * Run one of the surface's actions as the claimant (GENC-1660): an option by its id, `select`
+     * with `{ options }`, or `reply` with `{ text }`. It runs the same code the widget's own button
+     * runs, and records the decision for the asking tool — the choice as the person would read it,
+     * and `note`, verbatim, as what they were shown about it — so `recordDecision` is not needed.
+     *
+     * A finishing action settles the interaction AS the claimant, as {@link InteractionHold.resolve}
+     * does, so it is stamped `answeredBy` the claimant.
+     *
+     * Refused, with nothing run, unless this interceptor holds the interaction right now, the
+     * surface has that action, it is enabled and `args` fit it. One action runs at a time: a call
+     * made while an earlier one on the same interaction is still running is refused as `'busy'`, to
+     * be tried again once that one has returned. A refusal lists what is enabled, so the caller can
+     * correct itself. `finished` says whether the interaction settled.
+     *
+     * Handing the interaction to the person (`set('user')`) while a finishing action is still
+     * running does not take that action's credit away: if it settles the interaction, the answer is
+     * the claimant's. If it does not, the interaction is the person's like any other.
+     */
+    invoke(action: string, args?: unknown, options?: {
+        note?: string;
+    }): Promise<InvokeResult>;
 }
 /**
  * What the working agent is told about an interaction an interceptor answered (GENC-1660): added
  * to the result of the tool call that requested it, as `decidedOnUsersBehalf` on an object result
  * or as a line appended to a text one.
  *
- * Built only from what the platform already holds — the claimant's framing, and the choice and
- * narration it recorded — so the text the person saw and the text the agent is told about are the
+ * Built only from what the platform already holds — the claimant's framing, and the choice,
+ * narration and edits it recorded — so the text the person saw and the text the agent is told about are the
  * same string. It never names the claimant, so the agent has nothing to repeat about one.
  *
  * @beta
@@ -56,6 +79,33 @@ export interface DelegatedDecision {
     readonly choice?: string;
     /** What the person was shown about it, verbatim, as the assistant's own words. */
     readonly shownToUser?: string;
+    /**
+     * What the claimant changed in the widget before it decided, in order, each as the claimant
+     * reported it (`InteractionEdit.choice`): present only when it made edits. Lets the agent know
+     * the interaction was altered, not just answered.
+     */
+    readonly edits?: readonly string[];
+}
+/**
+ * What the working agent is told when the PERSON settled an interaction an interceptor had already
+ * changed (GENC-1660): added to the result of the tool call that requested it, as
+ * `editedOnUsersBehalf` on an object result or as a line appended to a text one. The edits were
+ * made on the user's behalf before they answered; the user then confirmed them by finishing it, so
+ * the answer itself is theirs and is not a {@link DelegatedDecision}.
+ *
+ * Built, like a decision, only from what the platform holds — the claimant's framing and the edits
+ * it reported — and never names the claimant.
+ *
+ * @beta
+ */
+export interface DelegatedEdits {
+    /**
+     * The claimant's {@link InteractionInterceptor.editFraming}, e.g. "Changed on the user's behalf
+     * before they answered; the user then finished it, confirming the changes".
+     */
+    readonly framing: string;
+    /** What the claimant changed, in order, each as it reported it (`InteractionEdit.choice`). */
+    readonly edits: readonly string[];
 }
 /**
  * A new interaction, as offered to each installed interceptor (GENC-1660).
@@ -103,6 +153,14 @@ export interface InteractionInterceptor {
      * would say "Decided on the user's behalf, from their brief".
      */
     readonly decisionFraming?: string;
+    /**
+     * How {@link DelegatedEdits} open, as the working agent reads them: the person finished an
+     * interaction this interceptor had changed first. Must say the changes were made on the user's
+     * behalf before they answered, and that finishing it confirmed them; must not name the
+     * interceptor. Defaults to "Changed on the user's behalf before the user answered; the user then
+     * finished it, confirming the changes".
+     */
+    readonly editFraming?: string;
     /** Return `'claim'` to hold the interaction, or nothing to leave it with the person. */
     onInteractionOpened(opened: InteractionOpened): 'claim' | undefined | void;
 }

package/dist/dts/types/interaction-interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interaction-interceptor.d.ts","sourceRoot":"","sources":["../../../src/types/interaction-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;IAC1C;;;;;;;;OAQG;IACH,cAAc,CAAC,QAAQ,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAC7E;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,0GAA0G;IAC1G,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC,oGAAoG;IACpG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,wFAAwF;IACxF,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;CAC5E"}
+{"version":3,"file":"interaction-interceptor.d.ts","sourceRoot":"","sources":["../../../src/types/interaction-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;IAC1C;;;;;;;;OAQG;IACH,cAAc,CAAC,QAAQ,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAC7E;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAClC;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5F;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,0GAA0G;IAC1G,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC,oGAAoG;IACpG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wFAAwF;IACxF,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;CAC5E"}