@athenaintel/react 0.60.0 → 0.61.0

package/dist/agent-ui/pace.cjs

@@ -0,0 +1,121 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const POINT_DEFAULT_MS = 5e3;
+const POINT_MAX_MS = 3e4;
+const STEP_MIN_MS = 2500;
+const STEP_MS_PER_CHAR = 45;
+const STEP_DEFAULT_MAX_MS = 12e3;
+const MAX_STEPS = 12;
+const NORMAL = {
+  smoothScroll: true,
+  scrollSettleMaxMs: 1200,
+  markBeforeActMs: 450,
+  cursorGlideMs: 400,
+  pressMs: 140,
+  typeCharMs: 60,
+  typeMaxMs: 2600,
+  typeByCharacter: true,
+  afterActMs: 350,
+  settleQuietMs: 150,
+  settleMaxMs: 1500,
+  lingerAfterActMs: 1200,
+  fadeMs: 600
+};
+const QUICK = {
+  ...NORMAL,
+  markBeforeActMs: 200,
+  cursorGlideMs: 200,
+  pressMs: 70,
+  typeCharMs: 25,
+  typeMaxMs: 1200,
+  afterActMs: 200,
+  lingerAfterActMs: 700,
+  fadeMs: 300
+};
+const INSTANT = {
+  smoothScroll: false,
+  scrollSettleMaxMs: 0,
+  markBeforeActMs: 0,
+  cursorGlideMs: 0,
+  pressMs: 0,
+  typeCharMs: 0,
+  typeMaxMs: 0,
+  typeByCharacter: false,
+  afterActMs: 0,
+  settleQuietMs: 0,
+  settleMaxMs: 0,
+  lingerAfterActMs: 0,
+  fadeMs: 0
+};
+function prefersReducedMotion(doc) {
+  var _a, _b;
+  try {
+    return ((_b = (_a = doc.defaultView) == null ? void 0 : _a.matchMedia) == null ? void 0 : _b.call(_a, "(prefers-reduced-motion: reduce)").matches) === true;
+  } catch {
+    return false;
+  }
+}
+function resolvePace({
+  speed,
+  reducedMotion
+}) {
+  const base = speed === "instant" ? INSTANT : speed === "quick" ? QUICK : NORMAL;
+  if (!reducedMotion || speed === "instant") return base;
+  return { ...base, smoothScroll: false, cursorGlideMs: 0, typeByCharacter: false };
+}
+class AgentUiInterrupted extends Error {
+  constructor(reason) {
+    super(reason === "person" ? "The person took over." : "The run was stopped.");
+    __publicField(this, "reason");
+    this.name = "AgentUiInterrupted";
+    this.reason = reason;
+  }
+}
+function interruptOf(signal) {
+  return new AgentUiInterrupted(signal.reason === "person" ? "person" : "stopped");
+}
+function throwIfInterrupted(signal) {
+  if (signal == null ? void 0 : signal.aborted) throw interruptOf(signal);
+}
+function pause(ms, signal) {
+  throwIfInterrupted(signal);
+  if (ms <= 0) return Promise.resolve();
+  return new Promise((resolve, reject) => {
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(signal ? interruptOf(signal) : new AgentUiInterrupted("stopped"));
+    };
+    const timer = setTimeout(() => {
+      signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+function stepDurationMs({ text, seconds }) {
+  if (typeof seconds === "number" && Number.isFinite(seconds) && seconds > 0) {
+    return Math.min(Math.max(seconds * 1e3, 1e3), POINT_MAX_MS);
+  }
+  return Math.min(Math.max(STEP_MIN_MS + text.length * STEP_MS_PER_CHAR, STEP_MIN_MS), STEP_DEFAULT_MAX_MS);
+}
+function pointDurationMs(seconds) {
+  if (typeof seconds !== "number" || !Number.isFinite(seconds) || seconds <= 0) return POINT_DEFAULT_MS;
+  return Math.min(Math.max(seconds * 1e3, 1e3), POINT_MAX_MS);
+}
+exports.AgentUiInterrupted = AgentUiInterrupted;
+exports.MAX_STEPS = MAX_STEPS;
+exports.POINT_DEFAULT_MS = POINT_DEFAULT_MS;
+exports.POINT_MAX_MS = POINT_MAX_MS;
+exports.STEP_DEFAULT_MAX_MS = STEP_DEFAULT_MAX_MS;
+exports.STEP_MIN_MS = STEP_MIN_MS;
+exports.STEP_MS_PER_CHAR = STEP_MS_PER_CHAR;
+exports.pause = pause;
+exports.pointDurationMs = pointDurationMs;
+exports.prefersReducedMotion = prefersReducedMotion;
+exports.resolvePace = resolvePace;
+exports.stepDurationMs = stepDurationMs;
+exports.throwIfInterrupted = throwIfInterrupted;
+//# sourceMappingURL=pace.cjs.map

package/dist/agent-ui/pace.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pace.cjs","sources":["../../src/agent-ui/pace.ts"],"sourcesContent":["/*\n * Pacing: every action the agent takes on the page is shown at a speed a\n * person can follow. It scrolls there, marks the element, then acts.\n *\n * The numbers follow what Athena's own surfaces already use: the highlight\n * stays five seconds unless told otherwise and thirty at most\n * (`highlight_in_asset`), the cursor glides in 400 ms (Athena in Chrome), and\n * a person who prefers reduced motion gets the same steps without the motion:\n * scrolls jump, the cursor lands in place and typed text arrives whole.\n */\n\n/** How fast the agent's actions play: at a followable pace, briskly, or with no waiting at all. */\nexport type AgentUiSpeed = 'normal' | 'quick' | 'instant';\n\nexport interface AgentUiPace {\n  /** Scroll smoothly (false: jump). */\n  smoothScroll: boolean;\n  /** The longest a scroll is waited on before the next step. */\n  scrollSettleMaxMs: number;\n  /** How long the mark shows on an element before the agent acts on it. */\n  markBeforeActMs: number;\n  /** The cursor's glide to an element. */\n  cursorGlideMs: number;\n  /** The pause between the cursor arriving and the click. */\n  pressMs: number;\n  /** One typed character. */\n  typeCharMs: number;\n  /** The longest typing a value takes; longer text is typed in larger pieces. */\n  typeMaxMs: number;\n  /** Type character by character (false: the whole value at once). */\n  typeByCharacter: boolean;\n  /** The pause after acting, before the page is read back. */\n  afterActMs: number;\n  /** How long the page must stay unchanged to count as settled, and the longest that is waited for. */\n  settleQuietMs: number;\n  settleMaxMs: number;\n  /** How long the mark stays after an action. */\n  lingerAfterActMs: number;\n  /** A mark's fade out. */\n  fadeMs: number;\n}\n\n/** How long `point_at` keeps its mark when the agent names no duration. */\nexport const POINT_DEFAULT_MS = 5_000;\n/** The longest a mark or a walkthrough step stays. */\nexport const POINT_MAX_MS = 30_000;\n/** The shortest a walkthrough step stays. */\nexport const STEP_MIN_MS = 2_500;\n/** A walkthrough step's reading time, per character of its text. */\nexport const STEP_MS_PER_CHAR = 45;\n/** The longest a step stays when the agent names no duration. */\nexport const STEP_DEFAULT_MAX_MS = 12_000;\n/** The most steps one walkthrough holds. */\nexport const MAX_STEPS = 12;\n\nconst NORMAL: AgentUiPace = {\n  smoothScroll: true,\n  scrollSettleMaxMs: 1_200,\n  markBeforeActMs: 450,\n  cursorGlideMs: 400,\n  pressMs: 140,\n  typeCharMs: 60,\n  typeMaxMs: 2_600,\n  typeByCharacter: true,\n  afterActMs: 350,\n  settleQuietMs: 150,\n  settleMaxMs: 1_500,\n  lingerAfterActMs: 1_200,\n  fadeMs: 600,\n};\n\nconst QUICK: AgentUiPace = {\n  ...NORMAL,\n  markBeforeActMs: 200,\n  cursorGlideMs: 200,\n  pressMs: 70,\n  typeCharMs: 25,\n  typeMaxMs: 1_200,\n  afterActMs: 200,\n  lingerAfterActMs: 700,\n  fadeMs: 300,\n};\n\nconst INSTANT: AgentUiPace = {\n  smoothScroll: false,\n  scrollSettleMaxMs: 0,\n  markBeforeActMs: 0,\n  cursorGlideMs: 0,\n  pressMs: 0,\n  typeCharMs: 0,\n  typeMaxMs: 0,\n  typeByCharacter: false,\n  afterActMs: 0,\n  settleQuietMs: 0,\n  settleMaxMs: 0,\n  lingerAfterActMs: 0,\n  fadeMs: 0,\n};\n\n/** Whether the person asked their system for less motion. */\nexport function prefersReducedMotion(doc: Document): boolean {\n  try {\n    return doc.defaultView?.matchMedia?.('(prefers-reduced-motion: reduce)').matches === true;\n  } catch {\n    return false;\n  }\n}\n\n/** The pace for a speed, with the motion taken out when the person prefers that. */\nexport function resolvePace({\n  speed,\n  reducedMotion,\n}: {\n  speed: AgentUiSpeed;\n  reducedMotion: boolean;\n}): AgentUiPace {\n  const base = speed === 'instant' ? INSTANT : speed === 'quick' ? QUICK : NORMAL;\n  if (!reducedMotion || speed === 'instant') return base;\n  // The same steps and holds, with nothing travelling.\n  return { ...base, smoothScroll: false, cursorGlideMs: 0, typeByCharacter: false };\n}\n\n/** Why an action in flight ended early. */\nexport type AgentUiInterruptReason = 'stopped' | 'person';\n\n/** Thrown through an action in flight when its run is stopped or the person takes over. */\nexport class AgentUiInterrupted extends Error {\n  readonly reason: AgentUiInterruptReason;\n\n  constructor(reason: AgentUiInterruptReason) {\n    super(reason === 'person' ? 'The person took over.' : 'The run was stopped.');\n    this.name = 'AgentUiInterrupted';\n    this.reason = reason;\n  }\n}\n\nfunction interruptOf(signal: AbortSignal): AgentUiInterrupted {\n  return new AgentUiInterrupted(signal.reason === 'person' ? 'person' : 'stopped');\n}\n\n/** Throws when the action was interrupted. */\nexport function throwIfInterrupted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw interruptOf(signal);\n}\n\n/** Wait `ms`, ending early (by throwing {@link AgentUiInterrupted}) when the action is interrupted. */\nexport function pause(ms: number, signal?: AbortSignal): Promise<void> {\n  throwIfInterrupted(signal);\n  if (ms <= 0) return Promise.resolve();\n  return new Promise<void>((resolve, reject) => {\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(signal ? interruptOf(signal) : new AgentUiInterrupted('stopped'));\n    };\n    const timer = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n\n/** The reading time of a walkthrough step that names no duration. */\nexport function stepDurationMs({ text, seconds }: { text: string; seconds?: number }): number {\n  if (typeof seconds === 'number' && Number.isFinite(seconds) && seconds > 0) {\n    return Math.min(Math.max(seconds * 1_000, 1_000), POINT_MAX_MS);\n  }\n  return Math.min(Math.max(STEP_MIN_MS + text.length * STEP_MS_PER_CHAR, STEP_MIN_MS), STEP_DEFAULT_MAX_MS);\n}\n\n/** How long a mark stays for the seconds the agent asked for. */\nexport function pointDurationMs(seconds: number | undefined): number {\n  if (typeof seconds !== 'number' || !Number.isFinite(seconds) || seconds <= 0) return POINT_DEFAULT_MS;\n  return Math.min(Math.max(seconds * 1_000, 1_000), POINT_MAX_MS);\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-ui/pace.d.ts

@@ -0,0 +1,66 @@
+/** How fast the agent's actions play: at a followable pace, briskly, or with no waiting at all. */
+export type AgentUiSpeed = 'normal' | 'quick' | 'instant';
+export interface AgentUiPace {
+    /** Scroll smoothly (false: jump). */
+    smoothScroll: boolean;
+    /** The longest a scroll is waited on before the next step. */
+    scrollSettleMaxMs: number;
+    /** How long the mark shows on an element before the agent acts on it. */
+    markBeforeActMs: number;
+    /** The cursor's glide to an element. */
+    cursorGlideMs: number;
+    /** The pause between the cursor arriving and the click. */
+    pressMs: number;
+    /** One typed character. */
+    typeCharMs: number;
+    /** The longest typing a value takes; longer text is typed in larger pieces. */
+    typeMaxMs: number;
+    /** Type character by character (false: the whole value at once). */
+    typeByCharacter: boolean;
+    /** The pause after acting, before the page is read back. */
+    afterActMs: number;
+    /** How long the page must stay unchanged to count as settled, and the longest that is waited for. */
+    settleQuietMs: number;
+    settleMaxMs: number;
+    /** How long the mark stays after an action. */
+    lingerAfterActMs: number;
+    /** A mark's fade out. */
+    fadeMs: number;
+}
+/** How long `point_at` keeps its mark when the agent names no duration. */
+export declare const POINT_DEFAULT_MS = 5000;
+/** The longest a mark or a walkthrough step stays. */
+export declare const POINT_MAX_MS = 30000;
+/** The shortest a walkthrough step stays. */
+export declare const STEP_MIN_MS = 2500;
+/** A walkthrough step's reading time, per character of its text. */
+export declare const STEP_MS_PER_CHAR = 45;
+/** The longest a step stays when the agent names no duration. */
+export declare const STEP_DEFAULT_MAX_MS = 12000;
+/** The most steps one walkthrough holds. */
+export declare const MAX_STEPS = 12;
+/** Whether the person asked their system for less motion. */
+export declare function prefersReducedMotion(doc: Document): boolean;
+/** The pace for a speed, with the motion taken out when the person prefers that. */
+export declare function resolvePace({ speed, reducedMotion, }: {
+    speed: AgentUiSpeed;
+    reducedMotion: boolean;
+}): AgentUiPace;
+/** Why an action in flight ended early. */
+export type AgentUiInterruptReason = 'stopped' | 'person';
+/** Thrown through an action in flight when its run is stopped or the person takes over. */
+export declare class AgentUiInterrupted extends Error {
+    readonly reason: AgentUiInterruptReason;
+    constructor(reason: AgentUiInterruptReason);
+}
+/** Throws when the action was interrupted. */
+export declare function throwIfInterrupted(signal: AbortSignal | undefined): void;
+/** Wait `ms`, ending early (by throwing {@link AgentUiInterrupted}) when the action is interrupted. */
+export declare function pause(ms: number, signal?: AbortSignal): Promise<void>;
+/** The reading time of a walkthrough step that names no duration. */
+export declare function stepDurationMs({ text, seconds }: {
+    text: string;
+    seconds?: number;
+}): number;
+/** How long a mark stays for the seconds the agent asked for. */
+export declare function pointDurationMs(seconds: number | undefined): number;

package/dist/agent-ui/pace.js

@@ -0,0 +1,121 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+const POINT_DEFAULT_MS = 5e3;
+const POINT_MAX_MS = 3e4;
+const STEP_MIN_MS = 2500;
+const STEP_MS_PER_CHAR = 45;
+const STEP_DEFAULT_MAX_MS = 12e3;
+const MAX_STEPS = 12;
+const NORMAL = {
+  smoothScroll: true,
+  scrollSettleMaxMs: 1200,
+  markBeforeActMs: 450,
+  cursorGlideMs: 400,
+  pressMs: 140,
+  typeCharMs: 60,
+  typeMaxMs: 2600,
+  typeByCharacter: true,
+  afterActMs: 350,
+  settleQuietMs: 150,
+  settleMaxMs: 1500,
+  lingerAfterActMs: 1200,
+  fadeMs: 600
+};
+const QUICK = {
+  ...NORMAL,
+  markBeforeActMs: 200,
+  cursorGlideMs: 200,
+  pressMs: 70,
+  typeCharMs: 25,
+  typeMaxMs: 1200,
+  afterActMs: 200,
+  lingerAfterActMs: 700,
+  fadeMs: 300
+};
+const INSTANT = {
+  smoothScroll: false,
+  scrollSettleMaxMs: 0,
+  markBeforeActMs: 0,
+  cursorGlideMs: 0,
+  pressMs: 0,
+  typeCharMs: 0,
+  typeMaxMs: 0,
+  typeByCharacter: false,
+  afterActMs: 0,
+  settleQuietMs: 0,
+  settleMaxMs: 0,
+  lingerAfterActMs: 0,
+  fadeMs: 0
+};
+function prefersReducedMotion(doc) {
+  var _a, _b;
+  try {
+    return ((_b = (_a = doc.defaultView) == null ? void 0 : _a.matchMedia) == null ? void 0 : _b.call(_a, "(prefers-reduced-motion: reduce)").matches) === true;
+  } catch {
+    return false;
+  }
+}
+function resolvePace({
+  speed,
+  reducedMotion
+}) {
+  const base = speed === "instant" ? INSTANT : speed === "quick" ? QUICK : NORMAL;
+  if (!reducedMotion || speed === "instant") return base;
+  return { ...base, smoothScroll: false, cursorGlideMs: 0, typeByCharacter: false };
+}
+class AgentUiInterrupted extends Error {
+  constructor(reason) {
+    super(reason === "person" ? "The person took over." : "The run was stopped.");
+    __publicField(this, "reason");
+    this.name = "AgentUiInterrupted";
+    this.reason = reason;
+  }
+}
+function interruptOf(signal) {
+  return new AgentUiInterrupted(signal.reason === "person" ? "person" : "stopped");
+}
+function throwIfInterrupted(signal) {
+  if (signal == null ? void 0 : signal.aborted) throw interruptOf(signal);
+}
+function pause(ms, signal) {
+  throwIfInterrupted(signal);
+  if (ms <= 0) return Promise.resolve();
+  return new Promise((resolve, reject) => {
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(signal ? interruptOf(signal) : new AgentUiInterrupted("stopped"));
+    };
+    const timer = setTimeout(() => {
+      signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+function stepDurationMs({ text, seconds }) {
+  if (typeof seconds === "number" && Number.isFinite(seconds) && seconds > 0) {
+    return Math.min(Math.max(seconds * 1e3, 1e3), POINT_MAX_MS);
+  }
+  return Math.min(Math.max(STEP_MIN_MS + text.length * STEP_MS_PER_CHAR, STEP_MIN_MS), STEP_DEFAULT_MAX_MS);
+}
+function pointDurationMs(seconds) {
+  if (typeof seconds !== "number" || !Number.isFinite(seconds) || seconds <= 0) return POINT_DEFAULT_MS;
+  return Math.min(Math.max(seconds * 1e3, 1e3), POINT_MAX_MS);
+}
+export {
+  AgentUiInterrupted,
+  MAX_STEPS,
+  POINT_DEFAULT_MS,
+  POINT_MAX_MS,
+  STEP_DEFAULT_MAX_MS,
+  STEP_MIN_MS,
+  STEP_MS_PER_CHAR,
+  pause,
+  pointDurationMs,
+  prefersReducedMotion,
+  resolvePace,
+  stepDurationMs,
+  throwIfInterrupted
+};
+//# sourceMappingURL=pace.js.map

package/dist/agent-ui/pace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pace.js","sources":["../../src/agent-ui/pace.ts"],"sourcesContent":["/*\n * Pacing: every action the agent takes on the page is shown at a speed a\n * person can follow. It scrolls there, marks the element, then acts.\n *\n * The numbers follow what Athena's own surfaces already use: the highlight\n * stays five seconds unless told otherwise and thirty at most\n * (`highlight_in_asset`), the cursor glides in 400 ms (Athena in Chrome), and\n * a person who prefers reduced motion gets the same steps without the motion:\n * scrolls jump, the cursor lands in place and typed text arrives whole.\n */\n\n/** How fast the agent's actions play: at a followable pace, briskly, or with no waiting at all. */\nexport type AgentUiSpeed = 'normal' | 'quick' | 'instant';\n\nexport interface AgentUiPace {\n  /** Scroll smoothly (false: jump). */\n  smoothScroll: boolean;\n  /** The longest a scroll is waited on before the next step. */\n  scrollSettleMaxMs: number;\n  /** How long the mark shows on an element before the agent acts on it. */\n  markBeforeActMs: number;\n  /** The cursor's glide to an element. */\n  cursorGlideMs: number;\n  /** The pause between the cursor arriving and the click. */\n  pressMs: number;\n  /** One typed character. */\n  typeCharMs: number;\n  /** The longest typing a value takes; longer text is typed in larger pieces. */\n  typeMaxMs: number;\n  /** Type character by character (false: the whole value at once). */\n  typeByCharacter: boolean;\n  /** The pause after acting, before the page is read back. */\n  afterActMs: number;\n  /** How long the page must stay unchanged to count as settled, and the longest that is waited for. */\n  settleQuietMs: number;\n  settleMaxMs: number;\n  /** How long the mark stays after an action. */\n  lingerAfterActMs: number;\n  /** A mark's fade out. */\n  fadeMs: number;\n}\n\n/** How long `point_at` keeps its mark when the agent names no duration. */\nexport const POINT_DEFAULT_MS = 5_000;\n/** The longest a mark or a walkthrough step stays. */\nexport const POINT_MAX_MS = 30_000;\n/** The shortest a walkthrough step stays. */\nexport const STEP_MIN_MS = 2_500;\n/** A walkthrough step's reading time, per character of its text. */\nexport const STEP_MS_PER_CHAR = 45;\n/** The longest a step stays when the agent names no duration. */\nexport const STEP_DEFAULT_MAX_MS = 12_000;\n/** The most steps one walkthrough holds. */\nexport const MAX_STEPS = 12;\n\nconst NORMAL: AgentUiPace = {\n  smoothScroll: true,\n  scrollSettleMaxMs: 1_200,\n  markBeforeActMs: 450,\n  cursorGlideMs: 400,\n  pressMs: 140,\n  typeCharMs: 60,\n  typeMaxMs: 2_600,\n  typeByCharacter: true,\n  afterActMs: 350,\n  settleQuietMs: 150,\n  settleMaxMs: 1_500,\n  lingerAfterActMs: 1_200,\n  fadeMs: 600,\n};\n\nconst QUICK: AgentUiPace = {\n  ...NORMAL,\n  markBeforeActMs: 200,\n  cursorGlideMs: 200,\n  pressMs: 70,\n  typeCharMs: 25,\n  typeMaxMs: 1_200,\n  afterActMs: 200,\n  lingerAfterActMs: 700,\n  fadeMs: 300,\n};\n\nconst INSTANT: AgentUiPace = {\n  smoothScroll: false,\n  scrollSettleMaxMs: 0,\n  markBeforeActMs: 0,\n  cursorGlideMs: 0,\n  pressMs: 0,\n  typeCharMs: 0,\n  typeMaxMs: 0,\n  typeByCharacter: false,\n  afterActMs: 0,\n  settleQuietMs: 0,\n  settleMaxMs: 0,\n  lingerAfterActMs: 0,\n  fadeMs: 0,\n};\n\n/** Whether the person asked their system for less motion. */\nexport function prefersReducedMotion(doc: Document): boolean {\n  try {\n    return doc.defaultView?.matchMedia?.('(prefers-reduced-motion: reduce)').matches === true;\n  } catch {\n    return false;\n  }\n}\n\n/** The pace for a speed, with the motion taken out when the person prefers that. */\nexport function resolvePace({\n  speed,\n  reducedMotion,\n}: {\n  speed: AgentUiSpeed;\n  reducedMotion: boolean;\n}): AgentUiPace {\n  const base = speed === 'instant' ? INSTANT : speed === 'quick' ? QUICK : NORMAL;\n  if (!reducedMotion || speed === 'instant') return base;\n  // The same steps and holds, with nothing travelling.\n  return { ...base, smoothScroll: false, cursorGlideMs: 0, typeByCharacter: false };\n}\n\n/** Why an action in flight ended early. */\nexport type AgentUiInterruptReason = 'stopped' | 'person';\n\n/** Thrown through an action in flight when its run is stopped or the person takes over. */\nexport class AgentUiInterrupted extends Error {\n  readonly reason: AgentUiInterruptReason;\n\n  constructor(reason: AgentUiInterruptReason) {\n    super(reason === 'person' ? 'The person took over.' : 'The run was stopped.');\n    this.name = 'AgentUiInterrupted';\n    this.reason = reason;\n  }\n}\n\nfunction interruptOf(signal: AbortSignal): AgentUiInterrupted {\n  return new AgentUiInterrupted(signal.reason === 'person' ? 'person' : 'stopped');\n}\n\n/** Throws when the action was interrupted. */\nexport function throwIfInterrupted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) throw interruptOf(signal);\n}\n\n/** Wait `ms`, ending early (by throwing {@link AgentUiInterrupted}) when the action is interrupted. */\nexport function pause(ms: number, signal?: AbortSignal): Promise<void> {\n  throwIfInterrupted(signal);\n  if (ms <= 0) return Promise.resolve();\n  return new Promise<void>((resolve, reject) => {\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(signal ? interruptOf(signal) : new AgentUiInterrupted('stopped'));\n    };\n    const timer = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n\n/** The reading time of a walkthrough step that names no duration. */\nexport function stepDurationMs({ text, seconds }: { text: string; seconds?: number }): number {\n  if (typeof seconds === 'number' && Number.isFinite(seconds) && seconds > 0) {\n    return Math.min(Math.max(seconds * 1_000, 1_000), POINT_MAX_MS);\n  }\n  return Math.min(Math.max(STEP_MIN_MS + text.length * STEP_MS_PER_CHAR, STEP_MIN_MS), STEP_DEFAULT_MAX_MS);\n}\n\n/** How long a mark stays for the seconds the agent asked for. */\nexport function pointDurationMs(seconds: number | undefined): number {\n  if (typeof seconds !== 'number' || !Number.isFinite(seconds) || seconds <= 0) return POINT_DEFAULT_MS;\n  return Math.min(Math.max(seconds * 1_000, 1_000), POINT_MAX_MS);\n}\n"],"names":[],"mappings":"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"}