@immediately-run/sdk 0.60.0 → 0.64.0

package/dist/agentPause.cjs

@@ -0,0 +1,68 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var agentPause_exports = {};
+__export(agentPause_exports, {
+  PauseController: () => PauseController
+});
+module.exports = __toCommonJS(agentPause_exports);
+class PauseController {
+  constructor() {
+    this.paused = false;
+    this.waiters = /* @__PURE__ */ new Set();
+    this.listeners = /* @__PURE__ */ new Set();
+  }
+  /** Set the pause state. Idempotent — setting the value it already holds does nothing. */
+  set(paused) {
+    if (this.paused === paused) return;
+    this.paused = paused;
+    if (!paused) {
+      const waiting = [...this.waiters];
+      this.waiters.clear();
+      for (const w of waiting) w();
+    }
+    for (const l of this.listeners) l(this.paused);
+  }
+  isPaused() {
+    return this.paused;
+  }
+  whenResumed(signal) {
+    if (!this.paused || signal?.aborted) return Promise.resolve();
+    return new Promise((resolve) => {
+      const done = () => {
+        this.waiters.delete(done);
+        signal?.removeEventListener("abort", done);
+        resolve();
+      };
+      this.waiters.add(done);
+      signal?.addEventListener("abort", done, { once: true });
+    });
+  }
+  /** Subscribe to pause changes (a UI showing "paused — this view is hidden"). */
+  onChange(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PauseController
+});
+//# sourceMappingURL=agentPause.cjs.map

package/dist/agentPause.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agentPause.ts"],"sourcesContent":["// Pause + resume for a run whose surface the user cannot see (R3-562;\n// AGENT_RUN_DURABILITY_SPEC §7 R-ARD-20a).\n//\n// WHY. The host now keeps a chrome region MOUNTED and merely hides it when the user\n// switches activity, so coming back does not reboot the app's iframe and destroy the\n// run (§7 R-ARD-20 — the T1 teardown). But hiding stops a frame PAINTING, not\n// executing, and a loop that keeps executing behind `display:none` + `inert` breaks a\n// requirement `LLM_AND_AGENTS_SPEC` §3.3 calls normative: the **loop observability\n// contract** wants a streaming transcript, a tool-call log rendered in order, a\n// reachable **stop button**, and every write visible at or before contribute. None of\n// that survives an inert subtree. It also contradicts R-ARD-15 one section earlier,\n// which forbids an agent writing files with no human present.\n//\n// So: kept-mounted, not kept-executing. The run pauses at its next turn boundary and\n// continues when the region is revealed. It costs nothing — the frame, the in-memory\n// loop state and the transcript all survive, so a reveal continues with zero waste, no\n// repair pass and no resume gate. The run is never torn down; it is only not advancing\n// while nobody can see or stop it.\n//\n// THE THREE VERBS ARE NOT THE SAME.\n//   * STOP   — `RunAgentOptions.signal`. Ends the run. The transcript so far is kept.\n//   * STEER  — `agentSteering.ts`. Ends the current TURN, injects a correction, CONTINUES.\n//   * PAUSE  — this controller. Ends nothing and injects nothing: the loop simply does\n//              not start its next turn until the pause lifts. The user did not ask for\n//              it and never sees it as an interruption — it is the host's fact about\n//              whether anyone is watching, so it leaves no mark in the transcript.\n//\n// WHY IT NEVER INTERRUPTS A TURN. The loop checks this at the TOP of an iteration, after\n// the previous iteration's tool batch has appended every `tool_result`. Pausing anywhere\n// else could leave a `tool_use` block without its pair, and the next request would then be\n// malformed and rejected by the provider for the whole conversation — the same property\n// `agentSteering` states for an interrupt, and for the same reason.\n\n/** What the loop needs from a pause source (so it can be faked in tests). */\nexport interface PauseSource {\n  /** Is the run currently not allowed to advance? Read at each turn boundary. */\n  isPaused(): boolean;\n  /**\n   * Resolves when the pause lifts — or immediately if it is already lifted.\n   *\n   * `signal` is the RUN's stop signal, and passing it is not optional in practice: a run\n   * stopped (or signed out) while its region is hidden would otherwise await a resume\n   * that never comes, and the awaited promise would keep the whole loop — transcript,\n   * tools, client — alive for the life of the tab. Resolving on abort hands control back\n   * to the loop, which re-checks `signal.aborted` and breaks.\n   */\n  whenResumed(signal?: AbortSignal): Promise<void>;\n}\n\n/**\n * The live pause state. Owned by the app (which sets it from the host's\n * `onRegionVisibilityChange`) and read by the loop.\n *\n * Deliberately NOT wired to the visibility channel in here: the controller is the\n * mechanism and knows nothing about why a run is paused, which keeps it usable for a\n * second reason later (a phone backgrounding, a user \"hold\" button) without this file\n * having an opinion about which reasons exist.\n */\nexport class PauseController implements PauseSource {\n  private paused = false;\n  private waiters = new Set<() => void>();\n  private listeners = new Set<(paused: boolean) => void>();\n\n  /** Set the pause state. Idempotent — setting the value it already holds does nothing. */\n  set(paused: boolean): void {\n    if (this.paused === paused) return;\n    this.paused = paused;\n    if (!paused) {\n      // Copy before draining: a waiter's continuation may synchronously pause again,\n      // and iterating the live set while it is being added to is how that turns into a\n      // lost or double-fired wake.\n      const waiting = [...this.waiters];\n      this.waiters.clear();\n      for (const w of waiting) w();\n    }\n    for (const l of this.listeners) l(this.paused);\n  }\n\n  isPaused(): boolean {\n    return this.paused;\n  }\n\n  whenResumed(signal?: AbortSignal): Promise<void> {\n    if (!this.paused || signal?.aborted) return Promise.resolve();\n    return new Promise<void>((resolve) => {\n      const done = (): void => {\n        this.waiters.delete(done);\n        signal?.removeEventListener('abort', done);\n        resolve();\n      };\n      this.waiters.add(done);\n      signal?.addEventListener('abort', done, { once: true });\n    });\n  }\n\n  /** Subscribe to pause changes (a UI showing \"paused — this view is hidden\"). */\n  onChange(listener: (paused: boolean) => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA0DO,MAAM,gBAAuC;AAAA,EAA7C;AACL,SAAQ,SAAS;AACjB,SAAQ,UAAU,oBAAI,IAAgB;AACtC,SAAQ,YAAY,oBAAI,IAA+B;AAAA;AAAA;AAAA,EAGvD,IAAI,QAAuB;AACzB,QAAI,KAAK,WAAW,OAAQ;AAC5B,SAAK,SAAS;AACd,QAAI,CAAC,QAAQ;AAIX,YAAM,UAAU,CAAC,GAAG,KAAK,OAAO;AAChC,WAAK,QAAQ,MAAM;AACnB,iBAAW,KAAK,QAAS,GAAE;AAAA,IAC7B;AACA,eAAW,KAAK,KAAK,UAAW,GAAE,KAAK,MAAM;AAAA,EAC/C;AAAA,EAEA,WAAoB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAY,QAAqC;AAC/C,QAAI,CAAC,KAAK,UAAU,QAAQ,QAAS,QAAO,QAAQ,QAAQ;AAC5D,WAAO,IAAI,QAAc,CAAC,YAAY;AACpC,YAAM,OAAO,MAAY;AACvB,aAAK,QAAQ,OAAO,IAAI;AACxB,gBAAQ,oBAAoB,SAAS,IAAI;AACzC,gBAAQ;AAAA,MACV;AACA,WAAK,QAAQ,IAAI,IAAI;AACrB,cAAQ,iBAAiB,SAAS,MAAM,EAAE,MAAM,KAAK,CAAC;AAAA,IACxD,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,SAAS,UAAiD;AACxD,SAAK,UAAU,IAAI,QAAQ;AAC3B,WAAO,MAAM;AACX,WAAK,UAAU,OAAO,QAAQ;AAAA,IAChC;AAAA,EACF;AACF;","names":[]}

package/dist/agentPause.d.cts

@@ -0,0 +1,37 @@
+/** What the loop needs from a pause source (so it can be faked in tests). */
+interface PauseSource {
+    /** Is the run currently not allowed to advance? Read at each turn boundary. */
+    isPaused(): boolean;
+    /**
+     * Resolves when the pause lifts — or immediately if it is already lifted.
+     *
+     * `signal` is the RUN's stop signal, and passing it is not optional in practice: a run
+     * stopped (or signed out) while its region is hidden would otherwise await a resume
+     * that never comes, and the awaited promise would keep the whole loop — transcript,
+     * tools, client — alive for the life of the tab. Resolving on abort hands control back
+     * to the loop, which re-checks `signal.aborted` and breaks.
+     */
+    whenResumed(signal?: AbortSignal): Promise<void>;
+}
+/**
+ * The live pause state. Owned by the app (which sets it from the host's
+ * `onRegionVisibilityChange`) and read by the loop.
+ *
+ * Deliberately NOT wired to the visibility channel in here: the controller is the
+ * mechanism and knows nothing about why a run is paused, which keeps it usable for a
+ * second reason later (a phone backgrounding, a user "hold" button) without this file
+ * having an opinion about which reasons exist.
+ */
+declare class PauseController implements PauseSource {
+    private paused;
+    private waiters;
+    private listeners;
+    /** Set the pause state. Idempotent — setting the value it already holds does nothing. */
+    set(paused: boolean): void;
+    isPaused(): boolean;
+    whenResumed(signal?: AbortSignal): Promise<void>;
+    /** Subscribe to pause changes (a UI showing "paused — this view is hidden"). */
+    onChange(listener: (paused: boolean) => void): () => void;
+}
+
+export { PauseController, type PauseSource };

package/dist/agentPause.d.ts

@@ -0,0 +1,37 @@
+/** What the loop needs from a pause source (so it can be faked in tests). */
+interface PauseSource {
+    /** Is the run currently not allowed to advance? Read at each turn boundary. */
+    isPaused(): boolean;
+    /**
+     * Resolves when the pause lifts — or immediately if it is already lifted.
+     *
+     * `signal` is the RUN's stop signal, and passing it is not optional in practice: a run
+     * stopped (or signed out) while its region is hidden would otherwise await a resume
+     * that never comes, and the awaited promise would keep the whole loop — transcript,
+     * tools, client — alive for the life of the tab. Resolving on abort hands control back
+     * to the loop, which re-checks `signal.aborted` and breaks.
+     */
+    whenResumed(signal?: AbortSignal): Promise<void>;
+}
+/**
+ * The live pause state. Owned by the app (which sets it from the host's
+ * `onRegionVisibilityChange`) and read by the loop.
+ *
+ * Deliberately NOT wired to the visibility channel in here: the controller is the
+ * mechanism and knows nothing about why a run is paused, which keeps it usable for a
+ * second reason later (a phone backgrounding, a user "hold" button) without this file
+ * having an opinion about which reasons exist.
+ */
+declare class PauseController implements PauseSource {
+    private paused;
+    private waiters;
+    private listeners;
+    /** Set the pause state. Idempotent — setting the value it already holds does nothing. */
+    set(paused: boolean): void;
+    isPaused(): boolean;
+    whenResumed(signal?: AbortSignal): Promise<void>;
+    /** Subscribe to pause changes (a UI showing "paused — this view is hidden"). */
+    onChange(listener: (paused: boolean) => void): () => void;
+}
+
+export { PauseController, type PauseSource };

package/dist/agentPause.js

@@ -0,0 +1,45 @@
+import "./chunk-VHAA22YE.js";
+class PauseController {
+  constructor() {
+    this.paused = false;
+    this.waiters = /* @__PURE__ */ new Set();
+    this.listeners = /* @__PURE__ */ new Set();
+  }
+  /** Set the pause state. Idempotent — setting the value it already holds does nothing. */
+  set(paused) {
+    if (this.paused === paused) return;
+    this.paused = paused;
+    if (!paused) {
+      const waiting = [...this.waiters];
+      this.waiters.clear();
+      for (const w of waiting) w();
+    }
+    for (const l of this.listeners) l(this.paused);
+  }
+  isPaused() {
+    return this.paused;
+  }
+  whenResumed(signal) {
+    if (!this.paused || signal?.aborted) return Promise.resolve();
+    return new Promise((resolve) => {
+      const done = () => {
+        this.waiters.delete(done);
+        signal?.removeEventListener("abort", done);
+        resolve();
+      };
+      this.waiters.add(done);
+      signal?.addEventListener("abort", done, { once: true });
+    });
+  }
+  /** Subscribe to pause changes (a UI showing "paused — this view is hidden"). */
+  onChange(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+}
+export {
+  PauseController
+};
+//# sourceMappingURL=agentPause.js.map

package/dist/agentPause.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agentPause.ts"],"sourcesContent":["// Pause + resume for a run whose surface the user cannot see (R3-562;\n// AGENT_RUN_DURABILITY_SPEC §7 R-ARD-20a).\n//\n// WHY. The host now keeps a chrome region MOUNTED and merely hides it when the user\n// switches activity, so coming back does not reboot the app's iframe and destroy the\n// run (§7 R-ARD-20 — the T1 teardown). But hiding stops a frame PAINTING, not\n// executing, and a loop that keeps executing behind `display:none` + `inert` breaks a\n// requirement `LLM_AND_AGENTS_SPEC` §3.3 calls normative: the **loop observability\n// contract** wants a streaming transcript, a tool-call log rendered in order, a\n// reachable **stop button**, and every write visible at or before contribute. None of\n// that survives an inert subtree. It also contradicts R-ARD-15 one section earlier,\n// which forbids an agent writing files with no human present.\n//\n// So: kept-mounted, not kept-executing. The run pauses at its next turn boundary and\n// continues when the region is revealed. It costs nothing — the frame, the in-memory\n// loop state and the transcript all survive, so a reveal continues with zero waste, no\n// repair pass and no resume gate. The run is never torn down; it is only not advancing\n// while nobody can see or stop it.\n//\n// THE THREE VERBS ARE NOT THE SAME.\n//   * STOP   — `RunAgentOptions.signal`. Ends the run. The transcript so far is kept.\n//   * STEER  — `agentSteering.ts`. Ends the current TURN, injects a correction, CONTINUES.\n//   * PAUSE  — this controller. Ends nothing and injects nothing: the loop simply does\n//              not start its next turn until the pause lifts. The user did not ask for\n//              it and never sees it as an interruption — it is the host's fact about\n//              whether anyone is watching, so it leaves no mark in the transcript.\n//\n// WHY IT NEVER INTERRUPTS A TURN. The loop checks this at the TOP of an iteration, after\n// the previous iteration's tool batch has appended every `tool_result`. Pausing anywhere\n// else could leave a `tool_use` block without its pair, and the next request would then be\n// malformed and rejected by the provider for the whole conversation — the same property\n// `agentSteering` states for an interrupt, and for the same reason.\n\n/** What the loop needs from a pause source (so it can be faked in tests). */\nexport interface PauseSource {\n  /** Is the run currently not allowed to advance? Read at each turn boundary. */\n  isPaused(): boolean;\n  /**\n   * Resolves when the pause lifts — or immediately if it is already lifted.\n   *\n   * `signal` is the RUN's stop signal, and passing it is not optional in practice: a run\n   * stopped (or signed out) while its region is hidden would otherwise await a resume\n   * that never comes, and the awaited promise would keep the whole loop — transcript,\n   * tools, client — alive for the life of the tab. Resolving on abort hands control back\n   * to the loop, which re-checks `signal.aborted` and breaks.\n   */\n  whenResumed(signal?: AbortSignal): Promise<void>;\n}\n\n/**\n * The live pause state. Owned by the app (which sets it from the host's\n * `onRegionVisibilityChange`) and read by the loop.\n *\n * Deliberately NOT wired to the visibility channel in here: the controller is the\n * mechanism and knows nothing about why a run is paused, which keeps it usable for a\n * second reason later (a phone backgrounding, a user \"hold\" button) without this file\n * having an opinion about which reasons exist.\n */\nexport class PauseController implements PauseSource {\n  private paused = false;\n  private waiters = new Set<() => void>();\n  private listeners = new Set<(paused: boolean) => void>();\n\n  /** Set the pause state. Idempotent — setting the value it already holds does nothing. */\n  set(paused: boolean): void {\n    if (this.paused === paused) return;\n    this.paused = paused;\n    if (!paused) {\n      // Copy before draining: a waiter's continuation may synchronously pause again,\n      // and iterating the live set while it is being added to is how that turns into a\n      // lost or double-fired wake.\n      const waiting = [...this.waiters];\n      this.waiters.clear();\n      for (const w of waiting) w();\n    }\n    for (const l of this.listeners) l(this.paused);\n  }\n\n  isPaused(): boolean {\n    return this.paused;\n  }\n\n  whenResumed(signal?: AbortSignal): Promise<void> {\n    if (!this.paused || signal?.aborted) return Promise.resolve();\n    return new Promise<void>((resolve) => {\n      const done = (): void => {\n        this.waiters.delete(done);\n        signal?.removeEventListener('abort', done);\n        resolve();\n      };\n      this.waiters.add(done);\n      signal?.addEventListener('abort', done, { once: true });\n    });\n  }\n\n  /** Subscribe to pause changes (a UI showing \"paused — this view is hidden\"). */\n  onChange(listener: (paused: boolean) => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n}\n"],"mappings":";AA0DO,MAAM,gBAAuC;AAAA,EAA7C;AACL,SAAQ,SAAS;AACjB,SAAQ,UAAU,oBAAI,IAAgB;AACtC,SAAQ,YAAY,oBAAI,IAA+B;AAAA;AAAA;AAAA,EAGvD,IAAI,QAAuB;AACzB,QAAI,KAAK,WAAW,OAAQ;AAC5B,SAAK,SAAS;AACd,QAAI,CAAC,QAAQ;AAIX,YAAM,UAAU,CAAC,GAAG,KAAK,OAAO;AAChC,WAAK,QAAQ,MAAM;AACnB,iBAAW,KAAK,QAAS,GAAE;AAAA,IAC7B;AACA,eAAW,KAAK,KAAK,UAAW,GAAE,KAAK,MAAM;AAAA,EAC/C;AAAA,EAEA,WAAoB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAY,QAAqC;AAC/C,QAAI,CAAC,KAAK,UAAU,QAAQ,QAAS,QAAO,QAAQ,QAAQ;AAC5D,WAAO,IAAI,QAAc,CAAC,YAAY;AACpC,YAAM,OAAO,MAAY;AACvB,aAAK,QAAQ,OAAO,IAAI;AACxB,gBAAQ,oBAAoB,SAAS,IAAI;AACzC,gBAAQ;AAAA,MACV;AACA,WAAK,QAAQ,IAAI,IAAI;AACrB,cAAQ,iBAAiB,SAAS,MAAM,EAAE,MAAM,KAAK,CAAC;AAAA,IACxD,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,SAAS,UAAiD;AACxD,SAAK,UAAU,IAAI,QAAQ;AAC3B,WAAO,MAAM;AACX,WAAK,UAAU,OAAO,QAAQ;AAAA,IAChC;AAAA,EACF;AACF;","names":[]}

package/dist/anchorClick.cjs

@@ -0,0 +1,40 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var anchorClick_exports = {};
+__export(anchorClick_exports, {
+  isBrowserGestureClick: () => isBrowserGestureClick,
+  useComposedAnchorClick: () => useComposedAnchorClick
+});
+module.exports = __toCommonJS(anchorClick_exports);
+var import_react = require("react");
+const isBrowserGestureClick = (event) => event.metaKey || event.ctrlKey || event.shiftKey || event.altKey || event.button !== 0;
+const useComposedAnchorClick = (onClick, intercept, interceptDeps) => (0, import_react.useCallback)(
+  (e) => {
+    onClick?.(e);
+    if (e.defaultPrevented) return;
+    intercept(e);
+  },
+  [onClick, ...interceptDeps]
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isBrowserGestureClick,
+  useComposedAnchorClick
+});
+//# sourceMappingURL=anchorClick.cjs.map

package/dist/anchorClick.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/anchorClick.ts"],"sourcesContent":["// The click contract the link primitives share (`components/Link.tsx`, `platformLink.tsx`).\n//\n// Both spelled this out inline until it became one named contract, which is how they\n// drifted apart once already; R3-568 added a third spelling in `PlatformLink` and drifted\n// again (it ignored a caller-supplied `target`), so the contract and its guard now live in\n// one module that every primitive imports.\nimport { useCallback } from 'react';\nimport type { DependencyList, MouseEvent, MouseEventHandler } from 'react';\n\n/**\n * True when the click is the browser's to handle, not ours: a modified click or a\n * non-primary button means \"open this somewhere else\", and the sandbox permits that\n * (`allow-popups`) even where it forbids moving the top-level window.\n *\n * Intercepting these would take away open-in-new-tab, which is one of the two things\n * (with copy-link) that make an `href` worth rendering at all.\n */\nexport const isBrowserGestureClick = (event: MouseEvent<HTMLAnchorElement>): boolean =>\n  event.metaKey || event.ctrlKey || event.shiftKey || event.altKey || event.button !== 0;\n\n/**\n * Compose a consumer-supplied `onClick` with an interception: the consumer handler runs\n * FIRST, and calling `preventDefault()` in it opts the click out of the interception\n * entirely; otherwise `intercept` runs.\n *\n * `intercept` is re-created on every render, so it is deliberately NOT a dependency:\n * `interceptDeps` names the values it closes over, and the memo is invalidated exactly when\n * those change.\n */\nexport const useComposedAnchorClick = (\n  onClick: MouseEventHandler<HTMLAnchorElement> | undefined,\n  intercept: (e: MouseEvent<HTMLAnchorElement>) => void,\n  interceptDeps: DependencyList,\n): MouseEventHandler<HTMLAnchorElement> =>\n  useCallback(\n    (e: MouseEvent<HTMLAnchorElement>) => {\n      onClick?.(e);\n      if (e.defaultPrevented) return;\n      intercept(e);\n    },\n    [onClick, ...interceptDeps],\n  );\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,mBAA4B;AAWrB,MAAM,wBAAwB,CAAC,UACpC,MAAM,WAAW,MAAM,WAAW,MAAM,YAAY,MAAM,UAAU,MAAM,WAAW;AAWhF,MAAM,yBAAyB,CACpC,SACA,WACA,sBAEA;AAAA,EACE,CAAC,MAAqC;AACpC,cAAU,CAAC;AACX,QAAI,EAAE,iBAAkB;AACxB,cAAU,CAAC;AAAA,EACb;AAAA,EACA,CAAC,SAAS,GAAG,aAAa;AAC5B;","names":[]}

package/dist/anchorClick.d.cts

@@ -0,0 +1,23 @@
+import { MouseEvent, MouseEventHandler, DependencyList } from 'react';
+
+/**
+ * True when the click is the browser's to handle, not ours: a modified click or a
+ * non-primary button means "open this somewhere else", and the sandbox permits that
+ * (`allow-popups`) even where it forbids moving the top-level window.
+ *
+ * Intercepting these would take away open-in-new-tab, which is one of the two things
+ * (with copy-link) that make an `href` worth rendering at all.
+ */
+declare const isBrowserGestureClick: (event: MouseEvent<HTMLAnchorElement>) => boolean;
+/**
+ * Compose a consumer-supplied `onClick` with an interception: the consumer handler runs
+ * FIRST, and calling `preventDefault()` in it opts the click out of the interception
+ * entirely; otherwise `intercept` runs.
+ *
+ * `intercept` is re-created on every render, so it is deliberately NOT a dependency:
+ * `interceptDeps` names the values it closes over, and the memo is invalidated exactly when
+ * those change.
+ */
+declare const useComposedAnchorClick: (onClick: MouseEventHandler<HTMLAnchorElement> | undefined, intercept: (e: MouseEvent<HTMLAnchorElement>) => void, interceptDeps: DependencyList) => MouseEventHandler<HTMLAnchorElement>;
+
+export { isBrowserGestureClick, useComposedAnchorClick };

package/dist/anchorClick.d.ts

@@ -0,0 +1,23 @@
+import { MouseEvent, MouseEventHandler, DependencyList } from 'react';
+
+/**
+ * True when the click is the browser's to handle, not ours: a modified click or a
+ * non-primary button means "open this somewhere else", and the sandbox permits that
+ * (`allow-popups`) even where it forbids moving the top-level window.
+ *
+ * Intercepting these would take away open-in-new-tab, which is one of the two things
+ * (with copy-link) that make an `href` worth rendering at all.
+ */
+declare const isBrowserGestureClick: (event: MouseEvent<HTMLAnchorElement>) => boolean;
+/**
+ * Compose a consumer-supplied `onClick` with an interception: the consumer handler runs
+ * FIRST, and calling `preventDefault()` in it opts the click out of the interception
+ * entirely; otherwise `intercept` runs.
+ *
+ * `intercept` is re-created on every render, so it is deliberately NOT a dependency:
+ * `interceptDeps` names the values it closes over, and the memo is invalidated exactly when
+ * those change.
+ */
+declare const useComposedAnchorClick: (onClick: MouseEventHandler<HTMLAnchorElement> | undefined, intercept: (e: MouseEvent<HTMLAnchorElement>) => void, interceptDeps: DependencyList) => MouseEventHandler<HTMLAnchorElement>;
+
+export { isBrowserGestureClick, useComposedAnchorClick };

package/dist/anchorClick.js

@@ -0,0 +1,16 @@
+import "./chunk-VHAA22YE.js";
+import { useCallback } from "react";
+const isBrowserGestureClick = (event) => event.metaKey || event.ctrlKey || event.shiftKey || event.altKey || event.button !== 0;
+const useComposedAnchorClick = (onClick, intercept, interceptDeps) => useCallback(
+  (e) => {
+    onClick?.(e);
+    if (e.defaultPrevented) return;
+    intercept(e);
+  },
+  [onClick, ...interceptDeps]
+);
+export {
+  isBrowserGestureClick,
+  useComposedAnchorClick
+};
+//# sourceMappingURL=anchorClick.js.map

package/dist/anchorClick.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/anchorClick.ts"],"sourcesContent":["// The click contract the link primitives share (`components/Link.tsx`, `platformLink.tsx`).\n//\n// Both spelled this out inline until it became one named contract, which is how they\n// drifted apart once already; R3-568 added a third spelling in `PlatformLink` and drifted\n// again (it ignored a caller-supplied `target`), so the contract and its guard now live in\n// one module that every primitive imports.\nimport { useCallback } from 'react';\nimport type { DependencyList, MouseEvent, MouseEventHandler } from 'react';\n\n/**\n * True when the click is the browser's to handle, not ours: a modified click or a\n * non-primary button means \"open this somewhere else\", and the sandbox permits that\n * (`allow-popups`) even where it forbids moving the top-level window.\n *\n * Intercepting these would take away open-in-new-tab, which is one of the two things\n * (with copy-link) that make an `href` worth rendering at all.\n */\nexport const isBrowserGestureClick = (event: MouseEvent<HTMLAnchorElement>): boolean =>\n  event.metaKey || event.ctrlKey || event.shiftKey || event.altKey || event.button !== 0;\n\n/**\n * Compose a consumer-supplied `onClick` with an interception: the consumer handler runs\n * FIRST, and calling `preventDefault()` in it opts the click out of the interception\n * entirely; otherwise `intercept` runs.\n *\n * `intercept` is re-created on every render, so it is deliberately NOT a dependency:\n * `interceptDeps` names the values it closes over, and the memo is invalidated exactly when\n * those change.\n */\nexport const useComposedAnchorClick = (\n  onClick: MouseEventHandler<HTMLAnchorElement> | undefined,\n  intercept: (e: MouseEvent<HTMLAnchorElement>) => void,\n  interceptDeps: DependencyList,\n): MouseEventHandler<HTMLAnchorElement> =>\n  useCallback(\n    (e: MouseEvent<HTMLAnchorElement>) => {\n      onClick?.(e);\n      if (e.defaultPrevented) return;\n      intercept(e);\n    },\n    [onClick, ...interceptDeps],\n  );\n"],"mappings":";AAMA,SAAS,mBAAmB;AAWrB,MAAM,wBAAwB,CAAC,UACpC,MAAM,WAAW,MAAM,WAAW,MAAM,YAAY,MAAM,UAAU,MAAM,WAAW;AAWhF,MAAM,yBAAyB,CACpC,SACA,WACA,kBAEA;AAAA,EACE,CAAC,MAAqC;AACpC,cAAU,CAAC;AACX,QAAI,EAAE,iBAAkB;AACxB,cAAU,CAAC;AAAA,EACb;AAAA,EACA,CAAC,SAAS,GAAG,aAAa;AAC5B;","names":[]}

package/dist/components/Link.cjs

@@ -25,25 +25,18 @@ __export(Link_exports, {
 module.exports = __toCommonJS(Link_exports);
 var import_jsx_runtime = require("react/jsx-runtime");
 var import_react = require("react");
+var import_anchorClick = require("../anchorClick");
 var import_routing = require("../routing");
 var import_scrollToId = require("../scrollToId");
 var import_TinkerableContext = require("../TinkerableContext");
 var import_urlUtils = require("../urlUtils");
-const useComposedAnchorClick = (onClick, intercept, interceptDeps) => (0, import_react.useCallback)(
-  (e) => {
-    onClick?.(e);
-    if (e.defaultPrevented) return;
-    intercept(e);
-  },
-  [onClick, ...interceptDeps]
-);
 const FragmentLink = ({
   href,
   children,
   onClick,
   ...props
 }) => {
-  const clickHandler = useComposedAnchorClick(
+  const clickHandler = (0, import_anchorClick.useComposedAnchorClick)(
     onClick,
     (e) => {
       if (href && href.startsWith("#")) {
@@ -62,11 +55,11 @@ const InternalLink = ({
   target,
   ...props
 }) => {
-  const clickHandler = useComposedAnchorClick(
+  const clickHandler = (0, import_anchorClick.useComposedAnchorClick)(
     onClick,
     (e) => {
       if (!href) return;
-      if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || e.button !== 0) return;
+      if ((0, import_anchorClick.isBrowserGestureClick)(e)) return;
       if (target && target !== "_self") return;
       e.preventDefault();
       (0, import_routing.navigate)(href);

package/dist/components/Link.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/Link.tsx"],"sourcesContent":["import { ReactNode, use, useCallback } from 'react';\nimport { navigate } from '../routing';\nimport { scrollToId } from '../scrollToId';\nimport { TinkerableContext } from '../TinkerableContext';\nimport { constructOuterUrl, isInternalHref } from '../urlUtils';\n\n/** The click contract shared by this module's link primitives: a consumer-supplied\n *  `onClick` is COMPOSED with the interception, never substituted for it. The\n *  consumer handler runs FIRST and calling `preventDefault()` in it opts the click\n *  out of the interception entirely; otherwise `intercept` runs. Both primitives\n *  spelled this out inline until they were one named contract, which is how they\n *  drifted apart once already (see {@link InternalLink}).\n *\n *  `intercept` is re-created on every render, so it is deliberately NOT a\n *  dependency: `interceptDeps` names the values it closes over, and the memo is\n *  invalidated exactly when those change — the dependency set each call site had\n *  when it wrote the handler out by hand. */\nconst useComposedAnchorClick = (\n  onClick: React.MouseEventHandler<HTMLAnchorElement> | undefined,\n  intercept: (e: React.MouseEvent<HTMLAnchorElement>) => void,\n  interceptDeps: React.DependencyList,\n): React.MouseEventHandler<HTMLAnchorElement> =>\n  useCallback(\n    (e: React.MouseEvent<HTMLAnchorElement>) => {\n      onClick?.(e);\n      if (e.defaultPrevented) return;\n      intercept(e);\n    },\n    [onClick, ...interceptDeps],\n  );\n\n/** A same-page anchor (`#frag`): scrolls the addressed section into view on click\n *  **without a route change** (MARKDOWN_SYNTAX_SPEC §13.5). The default behavior of a\n *  bare `#`-href is intercepted so the sandbox URL the host owns is never mutated\n *  out from under it; a fragment that names nothing leaves the scroll position\n *  untouched (a soft failure). */\nexport const FragmentLink = ({\n  href,\n  children,\n  onClick,\n  ...props\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const clickHandler = useComposedAnchorClick(\n    onClick,\n    (e) => {\n      if (href && href.startsWith('#')) {\n        e.preventDefault();\n        scrollToId(href.slice(1));\n      }\n    },\n    [href],\n  );\n  return (\n    <a href={href} onClick={clickHandler} {...props}>\n      {children}\n    </a>\n  );\n};\n\n/** An `<a>` that performs in-sandbox navigation on click (prevents the default\n *  full-page load and routes via {@link navigate}).\n *\n *  A consumer-supplied `onClick` is COMPOSED with the router interception, never\n *  substituted for it (`useComposedAnchorClick` above): it runs first, and\n *  calling `preventDefault()` opts out of routing. Regression guard: `...props`\n *  used to spread AFTER `onClick={clickHandler}`, so a consumer `onClick` (e.g. a\n *  drawer's close-on-navigate) silently REPLACED the interception — the default\n *  anchor action then navigated the sandboxed iframe itself to the host URL,\n *  reloading the whole app (and framing the host inside its own sandbox).\n *\n *  Modifier/middle clicks and explicit non-self `target`s keep the browser\n *  default: the rendered href is a real host URL, so open-in-new-tab works. */\nexport const InternalLink = ({\n  href,\n  children,\n  onClick,\n  target,\n  ...props\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const clickHandler = useComposedAnchorClick(\n    onClick,\n    (e) => {\n      if (!href) return;\n      // Open-in-new-tab gestures (and an explicit target) are the browser's.\n      if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || e.button !== 0) return;\n      if (target && target !== '_self') return;\n      e.preventDefault();\n      navigate(href);\n    },\n    [href, target],\n  );\n  // Spread FIRST so no forwarded prop can clobber the interception or the href.\n  return (\n    <a {...props} href={href} target={target} onClick={clickHandler}>\n      {children}\n    </a>\n  );\n};\n\n/** A link that routes same-app hrefs through the sandbox router (as an\n *  {@link InternalLink}) and renders external hrefs as a plain `<a>`. */\nexport const Link = ({\n  href,\n  children,\n  ...properties\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const { outerHref, navigationState } = use(TinkerableContext);\n  // A pure same-page fragment (`#sec-8-9`) scrolls in place — no route change (§13.5).\n  if (href && href.startsWith('#')) {\n    return (\n      <FragmentLink href={href} {...properties}>\n        {children}\n      </FragmentLink>\n    );\n  }\n  if (href && isInternalHref(outerHref, href, navigationState)) {\n    const targetHref = constructOuterUrl(outerHref, href, navigationState);\n    return (\n      <InternalLink href={targetHref} {...properties}>\n        {children}\n      </InternalLink>\n    );\n  } else {\n    // create a regular link to external resource\n    return <a {...{ href, ...properties }}>{children}</a>;\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqDI;AArDJ,mBAA4C;AAC5C,qBAAyB;AACzB,wBAA2B;AAC3B,+BAAkC;AAClC,sBAAkD;AAalD,MAAM,yBAAyB,CAC7B,SACA,WACA,sBAEA;AAAA,EACE,CAAC,MAA2C;AAC1C,cAAU,CAAC;AACX,QAAI,EAAE,iBAAkB;AACxB,cAAU,CAAC;AAAA,EACb;AAAA,EACA,CAAC,SAAS,GAAG,aAAa;AAC5B;AAOK,MAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,eAAe;AAAA,IACnB;AAAA,IACA,CAAC,MAAM;AACL,UAAI,QAAQ,KAAK,WAAW,GAAG,GAAG;AAChC,UAAE,eAAe;AACjB,0CAAW,KAAK,MAAM,CAAC,CAAC;AAAA,MAC1B;AAAA,IACF;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AACA,SACE,4CAAC,OAAE,MAAY,SAAS,cAAe,GAAG,OACvC,UACH;AAEJ;AAeO,MAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,eAAe;AAAA,IACnB;AAAA,IACA,CAAC,MAAM;AACL,UAAI,CAAC,KAAM;AAEX,UAAI,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAG;AACxE,UAAI,UAAU,WAAW,QAAS;AAClC,QAAE,eAAe;AACjB,mCAAS,IAAI;AAAA,IACf;AAAA,IACA,CAAC,MAAM,MAAM;AAAA,EACf;AAEA,SACE,4CAAC,OAAG,GAAG,OAAO,MAAY,QAAgB,SAAS,cAChD,UACH;AAEJ;AAIO,MAAM,OAAO,CAAC;AAAA,EACnB;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,EAAE,WAAW,gBAAgB,QAAI,kBAAI,0CAAiB;AAE5D,MAAI,QAAQ,KAAK,WAAW,GAAG,GAAG;AAChC,WACE,4CAAC,gBAAa,MAAa,GAAG,YAC3B,UACH;AAAA,EAEJ;AACA,MAAI,YAAQ,gCAAe,WAAW,MAAM,eAAe,GAAG;AAC5D,UAAM,iBAAa,mCAAkB,WAAW,MAAM,eAAe;AACrE,WACE,4CAAC,gBAAa,MAAM,YAAa,GAAG,YACjC,UACH;AAAA,EAEJ,OAAO;AAEL,WAAO,4CAAC,OAAG,GAAG,EAAE,MAAM,GAAG,WAAW,GAAI,UAAS;AAAA,EACnD;AACF;","names":[]}
+{"version":3,"sources":["../../src/components/Link.tsx"],"sourcesContent":["import { ReactNode, use } from 'react';\nimport { isBrowserGestureClick, useComposedAnchorClick } from '../anchorClick';\nimport { navigate } from '../routing';\nimport { scrollToId } from '../scrollToId';\nimport { TinkerableContext } from '../TinkerableContext';\nimport { constructOuterUrl, isInternalHref } from '../urlUtils';\n\n/** A same-page anchor (`#frag`): scrolls the addressed section into view on click\n *  **without a route change** (MARKDOWN_SYNTAX_SPEC §13.5). The default behavior of a\n *  bare `#`-href is intercepted so the sandbox URL the host owns is never mutated\n *  out from under it; a fragment that names nothing leaves the scroll position\n *  untouched (a soft failure). */\nexport const FragmentLink = ({\n  href,\n  children,\n  onClick,\n  ...props\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const clickHandler = useComposedAnchorClick(\n    onClick,\n    (e) => {\n      if (href && href.startsWith('#')) {\n        e.preventDefault();\n        scrollToId(href.slice(1));\n      }\n    },\n    [href],\n  );\n  return (\n    <a href={href} onClick={clickHandler} {...props}>\n      {children}\n    </a>\n  );\n};\n\n/** An `<a>` that performs in-sandbox navigation on click (prevents the default\n *  full-page load and routes via {@link navigate}).\n *\n *  A consumer-supplied `onClick` is COMPOSED with the router interception, never\n *  substituted for it (`useComposedAnchorClick`, `../anchorClick`): it runs first, and\n *  calling `preventDefault()` opts out of routing. Regression guard: `...props`\n *  used to spread AFTER `onClick={clickHandler}`, so a consumer `onClick` (e.g. a\n *  drawer's close-on-navigate) silently REPLACED the interception — the default\n *  anchor action then navigated the sandboxed iframe itself to the host URL,\n *  reloading the whole app (and framing the host inside its own sandbox).\n *\n *  Modifier/middle clicks and explicit non-self `target`s keep the browser\n *  default: the rendered href is a real host URL, so open-in-new-tab works. */\nexport const InternalLink = ({\n  href,\n  children,\n  onClick,\n  target,\n  ...props\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const clickHandler = useComposedAnchorClick(\n    onClick,\n    (e) => {\n      if (!href) return;\n      // Open-in-new-tab gestures (and an explicit target) are the browser's.\n      if (isBrowserGestureClick(e)) return;\n      if (target && target !== '_self') return;\n      e.preventDefault();\n      navigate(href);\n    },\n    [href, target],\n  );\n  // Spread FIRST so no forwarded prop can clobber the interception or the href.\n  return (\n    <a {...props} href={href} target={target} onClick={clickHandler}>\n      {children}\n    </a>\n  );\n};\n\n/** A link that routes same-app hrefs through the sandbox router (as an\n *  {@link InternalLink}) and renders external hrefs as a plain `<a>`. */\nexport const Link = ({\n  href,\n  children,\n  ...properties\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const { outerHref, navigationState } = use(TinkerableContext);\n  // A pure same-page fragment (`#sec-8-9`) scrolls in place — no route change (§13.5).\n  if (href && href.startsWith('#')) {\n    return (\n      <FragmentLink href={href} {...properties}>\n        {children}\n      </FragmentLink>\n    );\n  }\n  if (href && isInternalHref(outerHref, href, navigationState)) {\n    const targetHref = constructOuterUrl(outerHref, href, navigationState);\n    return (\n      <InternalLink href={targetHref} {...properties}>\n        {children}\n      </InternalLink>\n    );\n  } else {\n    // create a regular link to external resource\n    return <a {...{ href, ...properties }}>{children}</a>;\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA6BI;AA7BJ,mBAA+B;AAC/B,yBAA8D;AAC9D,qBAAyB;AACzB,wBAA2B;AAC3B,+BAAkC;AAClC,sBAAkD;AAO3C,MAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,mBAAe;AAAA,IACnB;AAAA,IACA,CAAC,MAAM;AACL,UAAI,QAAQ,KAAK,WAAW,GAAG,GAAG;AAChC,UAAE,eAAe;AACjB,0CAAW,KAAK,MAAM,CAAC,CAAC;AAAA,MAC1B;AAAA,IACF;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AACA,SACE,4CAAC,OAAE,MAAY,SAAS,cAAe,GAAG,OACvC,UACH;AAEJ;AAeO,MAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,mBAAe;AAAA,IACnB;AAAA,IACA,CAAC,MAAM;AACL,UAAI,CAAC,KAAM;AAEX,cAAI,0CAAsB,CAAC,EAAG;AAC9B,UAAI,UAAU,WAAW,QAAS;AAClC,QAAE,eAAe;AACjB,mCAAS,IAAI;AAAA,IACf;AAAA,IACA,CAAC,MAAM,MAAM;AAAA,EACf;AAEA,SACE,4CAAC,OAAG,GAAG,OAAO,MAAY,QAAgB,SAAS,cAChD,UACH;AAEJ;AAIO,MAAM,OAAO,CAAC;AAAA,EACnB;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,EAAE,WAAW,gBAAgB,QAAI,kBAAI,0CAAiB;AAE5D,MAAI,QAAQ,KAAK,WAAW,GAAG,GAAG;AAChC,WACE,4CAAC,gBAAa,MAAa,GAAG,YAC3B,UACH;AAAA,EAEJ;AACA,MAAI,YAAQ,gCAAe,WAAW,MAAM,eAAe,GAAG;AAC5D,UAAM,iBAAa,mCAAkB,WAAW,MAAM,eAAe;AACrE,WACE,4CAAC,gBAAa,MAAM,YAAa,GAAG,YACjC,UACH;AAAA,EAEJ,OAAO;AAEL,WAAO,4CAAC,OAAG,GAAG,EAAE,MAAM,GAAG,WAAW,GAAI,UAAS;AAAA,EACnD;AACF;","names":[]}

package/dist/components/Link.d.cts

@@ -10,7 +10,7 @@ declare const FragmentLink: ({ href, children, onClick, ...props }: React.Detail
  *  full-page load and routes via {@link navigate}).
  *
  *  A consumer-supplied `onClick` is COMPOSED with the router interception, never
- *  substituted for it (`useComposedAnchorClick` above): it runs first, and
+ *  substituted for it (`useComposedAnchorClick`, `../anchorClick`): it runs first, and
  *  calling `preventDefault()` opts out of routing. Regression guard: `...props`
  *  used to spread AFTER `onClick={clickHandler}`, so a consumer `onClick` (e.g. a
  *  drawer's close-on-navigate) silently REPLACED the interception — the default

package/dist/components/Link.d.ts

@@ -10,7 +10,7 @@ declare const FragmentLink: ({ href, children, onClick, ...props }: React.Detail
  *  full-page load and routes via {@link navigate}).
  *
  *  A consumer-supplied `onClick` is COMPOSED with the router interception, never
- *  substituted for it (`useComposedAnchorClick` above): it runs first, and
+ *  substituted for it (`useComposedAnchorClick`, `../anchorClick`): it runs first, and
  *  calling `preventDefault()` opts out of routing. Regression guard: `...props`
  *  used to spread AFTER `onClick={clickHandler}`, so a consumer `onClick` (e.g. a
  *  drawer's close-on-navigate) silently REPLACED the interception — the default

package/dist/components/Link.js

@@ -1,18 +1,11 @@
 import "../chunk-VHAA22YE.js";
 import { jsx } from "react/jsx-runtime";
-import { use, useCallback } from "react";
+import { use } from "react";
+import { isBrowserGestureClick, useComposedAnchorClick } from "../anchorClick";
 import { navigate } from "../routing";
 import { scrollToId } from "../scrollToId";
 import { TinkerableContext } from "../TinkerableContext";
 import { constructOuterUrl, isInternalHref } from "../urlUtils";
-const useComposedAnchorClick = (onClick, intercept, interceptDeps) => useCallback(
-  (e) => {
-    onClick?.(e);
-    if (e.defaultPrevented) return;
-    intercept(e);
-  },
-  [onClick, ...interceptDeps]
-);
 const FragmentLink = ({
   href,
   children,
@@ -42,7 +35,7 @@ const InternalLink = ({
     onClick,
     (e) => {
       if (!href) return;
-      if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || e.button !== 0) return;
+      if (isBrowserGestureClick(e)) return;
       if (target && target !== "_self") return;
       e.preventDefault();
       navigate(href);

package/dist/components/Link.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/Link.tsx"],"sourcesContent":["import { ReactNode, use, useCallback } from 'react';\nimport { navigate } from '../routing';\nimport { scrollToId } from '../scrollToId';\nimport { TinkerableContext } from '../TinkerableContext';\nimport { constructOuterUrl, isInternalHref } from '../urlUtils';\n\n/** The click contract shared by this module's link primitives: a consumer-supplied\n *  `onClick` is COMPOSED with the interception, never substituted for it. The\n *  consumer handler runs FIRST and calling `preventDefault()` in it opts the click\n *  out of the interception entirely; otherwise `intercept` runs. Both primitives\n *  spelled this out inline until they were one named contract, which is how they\n *  drifted apart once already (see {@link InternalLink}).\n *\n *  `intercept` is re-created on every render, so it is deliberately NOT a\n *  dependency: `interceptDeps` names the values it closes over, and the memo is\n *  invalidated exactly when those change — the dependency set each call site had\n *  when it wrote the handler out by hand. */\nconst useComposedAnchorClick = (\n  onClick: React.MouseEventHandler<HTMLAnchorElement> | undefined,\n  intercept: (e: React.MouseEvent<HTMLAnchorElement>) => void,\n  interceptDeps: React.DependencyList,\n): React.MouseEventHandler<HTMLAnchorElement> =>\n  useCallback(\n    (e: React.MouseEvent<HTMLAnchorElement>) => {\n      onClick?.(e);\n      if (e.defaultPrevented) return;\n      intercept(e);\n    },\n    [onClick, ...interceptDeps],\n  );\n\n/** A same-page anchor (`#frag`): scrolls the addressed section into view on click\n *  **without a route change** (MARKDOWN_SYNTAX_SPEC §13.5). The default behavior of a\n *  bare `#`-href is intercepted so the sandbox URL the host owns is never mutated\n *  out from under it; a fragment that names nothing leaves the scroll position\n *  untouched (a soft failure). */\nexport const FragmentLink = ({\n  href,\n  children,\n  onClick,\n  ...props\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const clickHandler = useComposedAnchorClick(\n    onClick,\n    (e) => {\n      if (href && href.startsWith('#')) {\n        e.preventDefault();\n        scrollToId(href.slice(1));\n      }\n    },\n    [href],\n  );\n  return (\n    <a href={href} onClick={clickHandler} {...props}>\n      {children}\n    </a>\n  );\n};\n\n/** An `<a>` that performs in-sandbox navigation on click (prevents the default\n *  full-page load and routes via {@link navigate}).\n *\n *  A consumer-supplied `onClick` is COMPOSED with the router interception, never\n *  substituted for it (`useComposedAnchorClick` above): it runs first, and\n *  calling `preventDefault()` opts out of routing. Regression guard: `...props`\n *  used to spread AFTER `onClick={clickHandler}`, so a consumer `onClick` (e.g. a\n *  drawer's close-on-navigate) silently REPLACED the interception — the default\n *  anchor action then navigated the sandboxed iframe itself to the host URL,\n *  reloading the whole app (and framing the host inside its own sandbox).\n *\n *  Modifier/middle clicks and explicit non-self `target`s keep the browser\n *  default: the rendered href is a real host URL, so open-in-new-tab works. */\nexport const InternalLink = ({\n  href,\n  children,\n  onClick,\n  target,\n  ...props\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const clickHandler = useComposedAnchorClick(\n    onClick,\n    (e) => {\n      if (!href) return;\n      // Open-in-new-tab gestures (and an explicit target) are the browser's.\n      if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || e.button !== 0) return;\n      if (target && target !== '_self') return;\n      e.preventDefault();\n      navigate(href);\n    },\n    [href, target],\n  );\n  // Spread FIRST so no forwarded prop can clobber the interception or the href.\n  return (\n    <a {...props} href={href} target={target} onClick={clickHandler}>\n      {children}\n    </a>\n  );\n};\n\n/** A link that routes same-app hrefs through the sandbox router (as an\n *  {@link InternalLink}) and renders external hrefs as a plain `<a>`. */\nexport const Link = ({\n  href,\n  children,\n  ...properties\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const { outerHref, navigationState } = use(TinkerableContext);\n  // A pure same-page fragment (`#sec-8-9`) scrolls in place — no route change (§13.5).\n  if (href && href.startsWith('#')) {\n    return (\n      <FragmentLink href={href} {...properties}>\n        {children}\n      </FragmentLink>\n    );\n  }\n  if (href && isInternalHref(outerHref, href, navigationState)) {\n    const targetHref = constructOuterUrl(outerHref, href, navigationState);\n    return (\n      <InternalLink href={targetHref} {...properties}>\n        {children}\n      </InternalLink>\n    );\n  } else {\n    // create a regular link to external resource\n    return <a {...{ href, ...properties }}>{children}</a>;\n  }\n};\n"],"mappings":";AAqDI;AArDJ,SAAoB,KAAK,mBAAmB;AAC5C,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,yBAAyB;AAClC,SAAS,mBAAmB,sBAAsB;AAalD,MAAM,yBAAyB,CAC7B,SACA,WACA,kBAEA;AAAA,EACE,CAAC,MAA2C;AAC1C,cAAU,CAAC;AACX,QAAI,EAAE,iBAAkB;AACxB,cAAU,CAAC;AAAA,EACb;AAAA,EACA,CAAC,SAAS,GAAG,aAAa;AAC5B;AAOK,MAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,eAAe;AAAA,IACnB;AAAA,IACA,CAAC,MAAM;AACL,UAAI,QAAQ,KAAK,WAAW,GAAG,GAAG;AAChC,UAAE,eAAe;AACjB,mBAAW,KAAK,MAAM,CAAC,CAAC;AAAA,MAC1B;AAAA,IACF;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AACA,SACE,oBAAC,OAAE,MAAY,SAAS,cAAe,GAAG,OACvC,UACH;AAEJ;AAeO,MAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,eAAe;AAAA,IACnB;AAAA,IACA,CAAC,MAAM;AACL,UAAI,CAAC,KAAM;AAEX,UAAI,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAG;AACxE,UAAI,UAAU,WAAW,QAAS;AAClC,QAAE,eAAe;AACjB,eAAS,IAAI;AAAA,IACf;AAAA,IACA,CAAC,MAAM,MAAM;AAAA,EACf;AAEA,SACE,oBAAC,OAAG,GAAG,OAAO,MAAY,QAAgB,SAAS,cAChD,UACH;AAEJ;AAIO,MAAM,OAAO,CAAC;AAAA,EACnB;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,EAAE,WAAW,gBAAgB,IAAI,IAAI,iBAAiB;AAE5D,MAAI,QAAQ,KAAK,WAAW,GAAG,GAAG;AAChC,WACE,oBAAC,gBAAa,MAAa,GAAG,YAC3B,UACH;AAAA,EAEJ;AACA,MAAI,QAAQ,eAAe,WAAW,MAAM,eAAe,GAAG;AAC5D,UAAM,aAAa,kBAAkB,WAAW,MAAM,eAAe;AACrE,WACE,oBAAC,gBAAa,MAAM,YAAa,GAAG,YACjC,UACH;AAAA,EAEJ,OAAO;AAEL,WAAO,oBAAC,OAAG,GAAG,EAAE,MAAM,GAAG,WAAW,GAAI,UAAS;AAAA,EACnD;AACF;","names":[]}
+{"version":3,"sources":["../../src/components/Link.tsx"],"sourcesContent":["import { ReactNode, use } from 'react';\nimport { isBrowserGestureClick, useComposedAnchorClick } from '../anchorClick';\nimport { navigate } from '../routing';\nimport { scrollToId } from '../scrollToId';\nimport { TinkerableContext } from '../TinkerableContext';\nimport { constructOuterUrl, isInternalHref } from '../urlUtils';\n\n/** A same-page anchor (`#frag`): scrolls the addressed section into view on click\n *  **without a route change** (MARKDOWN_SYNTAX_SPEC §13.5). The default behavior of a\n *  bare `#`-href is intercepted so the sandbox URL the host owns is never mutated\n *  out from under it; a fragment that names nothing leaves the scroll position\n *  untouched (a soft failure). */\nexport const FragmentLink = ({\n  href,\n  children,\n  onClick,\n  ...props\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const clickHandler = useComposedAnchorClick(\n    onClick,\n    (e) => {\n      if (href && href.startsWith('#')) {\n        e.preventDefault();\n        scrollToId(href.slice(1));\n      }\n    },\n    [href],\n  );\n  return (\n    <a href={href} onClick={clickHandler} {...props}>\n      {children}\n    </a>\n  );\n};\n\n/** An `<a>` that performs in-sandbox navigation on click (prevents the default\n *  full-page load and routes via {@link navigate}).\n *\n *  A consumer-supplied `onClick` is COMPOSED with the router interception, never\n *  substituted for it (`useComposedAnchorClick`, `../anchorClick`): it runs first, and\n *  calling `preventDefault()` opts out of routing. Regression guard: `...props`\n *  used to spread AFTER `onClick={clickHandler}`, so a consumer `onClick` (e.g. a\n *  drawer's close-on-navigate) silently REPLACED the interception — the default\n *  anchor action then navigated the sandboxed iframe itself to the host URL,\n *  reloading the whole app (and framing the host inside its own sandbox).\n *\n *  Modifier/middle clicks and explicit non-self `target`s keep the browser\n *  default: the rendered href is a real host URL, so open-in-new-tab works. */\nexport const InternalLink = ({\n  href,\n  children,\n  onClick,\n  target,\n  ...props\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const clickHandler = useComposedAnchorClick(\n    onClick,\n    (e) => {\n      if (!href) return;\n      // Open-in-new-tab gestures (and an explicit target) are the browser's.\n      if (isBrowserGestureClick(e)) return;\n      if (target && target !== '_self') return;\n      e.preventDefault();\n      navigate(href);\n    },\n    [href, target],\n  );\n  // Spread FIRST so no forwarded prop can clobber the interception or the href.\n  return (\n    <a {...props} href={href} target={target} onClick={clickHandler}>\n      {children}\n    </a>\n  );\n};\n\n/** A link that routes same-app hrefs through the sandbox router (as an\n *  {@link InternalLink}) and renders external hrefs as a plain `<a>`. */\nexport const Link = ({\n  href,\n  children,\n  ...properties\n}: React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>): ReactNode => {\n  const { outerHref, navigationState } = use(TinkerableContext);\n  // A pure same-page fragment (`#sec-8-9`) scrolls in place — no route change (§13.5).\n  if (href && href.startsWith('#')) {\n    return (\n      <FragmentLink href={href} {...properties}>\n        {children}\n      </FragmentLink>\n    );\n  }\n  if (href && isInternalHref(outerHref, href, navigationState)) {\n    const targetHref = constructOuterUrl(outerHref, href, navigationState);\n    return (\n      <InternalLink href={targetHref} {...properties}>\n        {children}\n      </InternalLink>\n    );\n  } else {\n    // create a regular link to external resource\n    return <a {...{ href, ...properties }}>{children}</a>;\n  }\n};\n"],"mappings":";AA6BI;AA7BJ,SAAoB,WAAW;AAC/B,SAAS,uBAAuB,8BAA8B;AAC9D,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,yBAAyB;AAClC,SAAS,mBAAmB,sBAAsB;AAO3C,MAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,eAAe;AAAA,IACnB;AAAA,IACA,CAAC,MAAM;AACL,UAAI,QAAQ,KAAK,WAAW,GAAG,GAAG;AAChC,UAAE,eAAe;AACjB,mBAAW,KAAK,MAAM,CAAC,CAAC;AAAA,MAC1B;AAAA,IACF;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AACA,SACE,oBAAC,OAAE,MAAY,SAAS,cAAe,GAAG,OACvC,UACH;AAEJ;AAeO,MAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,eAAe;AAAA,IACnB;AAAA,IACA,CAAC,MAAM;AACL,UAAI,CAAC,KAAM;AAEX,UAAI,sBAAsB,CAAC,EAAG;AAC9B,UAAI,UAAU,WAAW,QAAS;AAClC,QAAE,eAAe;AACjB,eAAS,IAAI;AAAA,IACf;AAAA,IACA,CAAC,MAAM,MAAM;AAAA,EACf;AAEA,SACE,oBAAC,OAAG,GAAG,OAAO,MAAY,QAAgB,SAAS,cAChD,UACH;AAEJ;AAIO,MAAM,OAAO,CAAC;AAAA,EACnB;AAAA,EACA;AAAA,EACA,GAAG;AACL,MAA4G;AAC1G,QAAM,EAAE,WAAW,gBAAgB,IAAI,IAAI,iBAAiB;AAE5D,MAAI,QAAQ,KAAK,WAAW,GAAG,GAAG;AAChC,WACE,oBAAC,gBAAa,MAAa,GAAG,YAC3B,UACH;AAAA,EAEJ;AACA,MAAI,QAAQ,eAAe,WAAW,MAAM,eAAe,GAAG;AAC5D,UAAM,aAAa,kBAAkB,WAAW,MAAM,eAAe;AACrE,WACE,oBAAC,gBAAa,MAAM,YAAa,GAAG,YACjC,UACH;AAAA,EAEJ,OAAO;AAEL,WAAO,oBAAC,OAAG,GAAG,EAAE,MAAM,GAAG,WAAW,GAAI,UAAS;AAAA,EACnD;AACF;","names":[]}

package/dist/index.cjs

@@ -58,6 +58,7 @@ __reExport(index_exports, require("./netFetch"), module.exports);
 __reExport(index_exports, require("./feed"), module.exports);
 __reExport(index_exports, require("./secrets"), module.exports);
 __reExport(index_exports, require("./recents"), module.exports);
+__reExport(index_exports, require("./openRepository"), module.exports);
 __reExport(index_exports, require("./llm"), module.exports);
 __reExport(index_exports, require("./diagnostics"), module.exports);
 __reExport(index_exports, require("./vcs"), module.exports);
@@ -76,6 +77,7 @@ __reExport(index_exports, require("./sandboxTypes"), module.exports);
 __reExport(index_exports, require("./safeContent"), module.exports);
 __reExport(index_exports, require("./agentLoop"), module.exports);
 __reExport(index_exports, require("./agentSteering"), module.exports);
+__reExport(index_exports, require("./agentPause"), module.exports);
 __reExport(index_exports, require("./agentChatClient"), module.exports);
 __reExport(index_exports, require("./metadataQueryTool"), module.exports);
 __reExport(index_exports, require("./collectHeadings"), module.exports);
@@ -119,6 +121,7 @@ __reExport(index_exports, require("./platformLink"), module.exports);
   ...require("./feed"),
   ...require("./secrets"),
   ...require("./recents"),
+  ...require("./openRepository"),
   ...require("./llm"),
   ...require("./diagnostics"),
   ...require("./vcs"),
@@ -137,6 +140,7 @@ __reExport(index_exports, require("./platformLink"), module.exports);
   ...require("./safeContent"),
   ...require("./agentLoop"),
   ...require("./agentSteering"),
+  ...require("./agentPause"),
   ...require("./agentChatClient"),
   ...require("./metadataQueryTool"),
   ...require("./collectHeadings"),

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './MDXProvider';\nexport * from './routing';\nexport * from './boot';\nexport * from './components/Include';\n// Only the component is public. `stripFrontmatter`/`appMountRelative` are module-level\n// exports so they can be unit-tested directly, NOT public API — the SDK's surface is\n// backwards-compatible forever, so an internal helper exported for a test's convenience is a\n// permanent commitment made for the wrong reason.\nexport { SafeInclude } from './components/SafeInclude';\nexport * from './sourceCache';\nexport * from './components/MDXComponents';\nexport * from './linkSpace';\nexport * from './bundle';\n// Deprecated `Corpus*` spellings of the above (R3-482); see `src/corpus.ts`.\nexport * from './corpus';\nexport * from './components/MountImage';\nexport * from './components/Routes';\nexport * from './hooks';\n// R3-276: the supported way for a viewer app to provide its own metadata store,\n// replacing a wholesale re-provision of `TinkerableContext` in app code.\nexport * from './metadataSource';\n// The deprecated injected-bundler adapters, re-exported so their deprecation notices\n// are visible in the published docs (R3-278; the window only narrows).\nexport { getInjectedMetadataEmitter, getInjectedMetadataSnapshot } from './injectedBundler';\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './editor';\nexport * from './formFactor';\nexport * from './chromeState';\nexport * from './workspace';\nexport * from './hostAttention';\nexport * from './region';\nexport * from './mounts';\nexport * from './analytics';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './ipc';\nexport * from './dnd';\nexport * from './netFetch';\nexport * from './feed';\nexport * from './secrets';\nexport * from './recents'; // R3-485: the gated recent-projects read (page.home)\nexport * from './llm';\nexport * from './diagnostics';\nexport * from './vcs';\nexport * from './onFsChange';\nexport * from './fs';\nexport * from './debug';\nexport * from './tasks';\nexport * from './launch';\nexport * from './runtime';\nexport * from './irMarkers';\nexport * from './ready';\nexport * from './loading';\nexport * from './protocolStream';\nexport * from './protocolDeadline';\nexport * from './sandboxTypes';\nexport * from './safeContent';\n// R3-489 (GROVE_AGENT_SPEC): the embedded-agent seam every app shares — the tool-use\n// loop ported from agent-demo (`runAgent` over the host chat slot), the MDX metadata\n// query tool, the headings index collector, the deixis context block, and the fence\n// for corpus-derived bytes entering a loop.\nexport * from './agentLoop';\nexport * from './agentSteering';\nexport * from './agentChatClient';\nexport * from './metadataQueryTool';\nexport * from './collectHeadings';\nexport * from './agentContext';\nexport * from './fence';\nexport * from './platformLink';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAAc,0BAAd;AACA,0BAAc,sBADd;AAEA,0BAAc,mBAFd;AAGA,0BAAc,iCAHd;AAQA,yBAA4B;AAC5B,0BAAc,0BATd;AAUA,0BAAc,uCAVd;AAWA,0BAAc,wBAXd;AAYA,0BAAc,qBAZd;AAcA,0BAAc,qBAdd;AAeA,0BAAc,oCAfd;AAgBA,0BAAc,gCAhBd;AAiBA,0BAAc,oBAjBd;AAoBA,0BAAc,6BApBd;AAuBA,6BAAwE;AACxE,0BAAc,mBAxBd;AAyBA,0BAAc,oBAzBd;AA0BA,0BAAc,4BA1Bd;AA2BA,0BAAc,qBA3Bd;AA4BA,0BAAc,yBA5Bd;AA6BA,0BAAc,0BA7Bd;AA8BA,0BAAc,wBA9Bd;AA+BA,0BAAc,4BA/Bd;AAgCA,0BAAc,qBAhCd;AAiCA,0BAAc,qBAjCd;AAkCA,0BAAc,wBAlCd;AAmCA,0BAAc,yBAnCd;AAoCA,0BAAc,sBApCd;AAqCA,0BAAc,kBArCd;AAsCA,0BAAc,kBAtCd;AAuCA,0BAAc,uBAvCd;AAwCA,0BAAc,mBAxCd;AAyCA,0BAAc,sBAzCd;AA0CA,0BAAc,sBA1Cd;AA2CA,0BAAc,kBA3Cd;AA4CA,0BAAc,0BA5Cd;AA6CA,0BAAc,kBA7Cd;AA8CA,0BAAc,yBA9Cd;AA+CA,0BAAc,iBA/Cd;AAgDA,0BAAc,oBAhDd;AAiDA,0BAAc,oBAjDd;AAkDA,0BAAc,qBAlDd;AAmDA,0BAAc,sBAnDd;AAoDA,0BAAc,wBApDd;AAqDA,0BAAc,oBArDd;AAsDA,0BAAc,sBAtDd;AAuDA,0BAAc,6BAvDd;AAwDA,0BAAc,+BAxDd;AAyDA,0BAAc,2BAzDd;AA0DA,0BAAc,0BA1Dd;AA+DA,0BAAc,wBA/Dd;AAgEA,0BAAc,4BAhEd;AAiEA,0BAAc,8BAjEd;AAkEA,0BAAc,gCAlEd;AAmEA,0BAAc,8BAnEd;AAoEA,0BAAc,2BApEd;AAqEA,0BAAc,oBArEd;AAsEA,0BAAc,2BAtEd;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './MDXProvider';\nexport * from './routing';\nexport * from './boot';\nexport * from './components/Include';\n// Only the component is public. `stripFrontmatter`/`appMountRelative` are module-level\n// exports so they can be unit-tested directly, NOT public API — the SDK's surface is\n// backwards-compatible forever, so an internal helper exported for a test's convenience is a\n// permanent commitment made for the wrong reason.\nexport { SafeInclude } from './components/SafeInclude';\nexport * from './sourceCache';\nexport * from './components/MDXComponents';\nexport * from './linkSpace';\nexport * from './bundle';\n// Deprecated `Corpus*` spellings of the above (R3-482); see `src/corpus.ts`.\nexport * from './corpus';\nexport * from './components/MountImage';\nexport * from './components/Routes';\nexport * from './hooks';\n// R3-276: the supported way for a viewer app to provide its own metadata store,\n// replacing a wholesale re-provision of `TinkerableContext` in app code.\nexport * from './metadataSource';\n// The deprecated injected-bundler adapters, re-exported so their deprecation notices\n// are visible in the published docs (R3-278; the window only narrows).\nexport { getInjectedMetadataEmitter, getInjectedMetadataSnapshot } from './injectedBundler';\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './editor';\nexport * from './formFactor';\nexport * from './chromeState';\nexport * from './workspace';\nexport * from './hostAttention';\nexport * from './region';\nexport * from './mounts';\nexport * from './analytics';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './ipc';\nexport * from './dnd';\nexport * from './netFetch';\nexport * from './feed';\nexport * from './secrets';\nexport * from './recents'; // R3-485: the gated recent-projects read (page.home)\nexport * from './openRepository'; // R3-476: host-mediated open-in-a-new-tab (route:read)\nexport * from './llm';\nexport * from './diagnostics';\nexport * from './vcs';\nexport * from './onFsChange';\nexport * from './fs';\nexport * from './debug';\nexport * from './tasks';\nexport * from './launch';\nexport * from './runtime';\nexport * from './irMarkers';\nexport * from './ready';\nexport * from './loading';\nexport * from './protocolStream';\nexport * from './protocolDeadline';\nexport * from './sandboxTypes';\nexport * from './safeContent';\n// R3-489 (GROVE_AGENT_SPEC): the embedded-agent seam every app shares — the tool-use\n// loop ported from agent-demo (`runAgent` over the host chat slot), the MDX metadata\n// query tool, the headings index collector, the deixis context block, and the fence\n// for corpus-derived bytes entering a loop.\nexport * from './agentLoop';\nexport * from './agentSteering';\nexport * from './agentPause';\nexport * from './agentChatClient';\nexport * from './metadataQueryTool';\nexport * from './collectHeadings';\nexport * from './agentContext';\nexport * from './fence';\nexport * from './platformLink';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAAc,0BAAd;AACA,0BAAc,sBADd;AAEA,0BAAc,mBAFd;AAGA,0BAAc,iCAHd;AAQA,yBAA4B;AAC5B,0BAAc,0BATd;AAUA,0BAAc,uCAVd;AAWA,0BAAc,wBAXd;AAYA,0BAAc,qBAZd;AAcA,0BAAc,qBAdd;AAeA,0BAAc,oCAfd;AAgBA,0BAAc,gCAhBd;AAiBA,0BAAc,oBAjBd;AAoBA,0BAAc,6BApBd;AAuBA,6BAAwE;AACxE,0BAAc,mBAxBd;AAyBA,0BAAc,oBAzBd;AA0BA,0BAAc,4BA1Bd;AA2BA,0BAAc,qBA3Bd;AA4BA,0BAAc,yBA5Bd;AA6BA,0BAAc,0BA7Bd;AA8BA,0BAAc,wBA9Bd;AA+BA,0BAAc,4BA/Bd;AAgCA,0BAAc,qBAhCd;AAiCA,0BAAc,qBAjCd;AAkCA,0BAAc,wBAlCd;AAmCA,0BAAc,yBAnCd;AAoCA,0BAAc,sBApCd;AAqCA,0BAAc,kBArCd;AAsCA,0BAAc,kBAtCd;AAuCA,0BAAc,uBAvCd;AAwCA,0BAAc,mBAxCd;AAyCA,0BAAc,sBAzCd;AA0CA,0BAAc,sBA1Cd;AA2CA,0BAAc,6BA3Cd;AA4CA,0BAAc,kBA5Cd;AA6CA,0BAAc,0BA7Cd;AA8CA,0BAAc,kBA9Cd;AA+CA,0BAAc,yBA/Cd;AAgDA,0BAAc,iBAhDd;AAiDA,0BAAc,oBAjDd;AAkDA,0BAAc,oBAlDd;AAmDA,0BAAc,qBAnDd;AAoDA,0BAAc,sBApDd;AAqDA,0BAAc,wBArDd;AAsDA,0BAAc,oBAtDd;AAuDA,0BAAc,sBAvDd;AAwDA,0BAAc,6BAxDd;AAyDA,0BAAc,+BAzDd;AA0DA,0BAAc,2BA1Dd;AA2DA,0BAAc,0BA3Dd;AAgEA,0BAAc,wBAhEd;AAiEA,0BAAc,4BAjEd;AAkEA,0BAAc,yBAlEd;AAmEA,0BAAc,8BAnEd;AAoEA,0BAAc,gCApEd;AAqEA,0BAAc,8BArEd;AAsEA,0BAAc,2BAtEd;AAuEA,0BAAc,oBAvEd;AAwEA,0BAAc,2BAxEd;","names":[]}

package/dist/index.d.cts

@@ -20,7 +20,7 @@ export { FormFactor, FormFactorClass, Orientation, getFormFactor, onFormFactorCh
 export { ChromeState, getChromeState, onChromeStateChange, useChromeState } from './chromeState.cjs';
 export { Workspace, getWorkspace, onWorkspaceChange, useWorkspace } from './workspace.cjs';
 export { HostAttention, HostAttentionKind, NO_HOST_ATTENTION, getHostAttention, onHostAttentionChange, useHostAttention } from './hostAttention.cjs';
-export { getRegion, useRegion } from './region.cjs';
+export { getRegion, isRegionHidden, onRegionVisibilityChange, useRegion, useRegionHidden } from './region.cjs';
 export { Invite, MountQuery, MountRemoveReason, MountRule, RemovedMount, SandboxMount, SessionMount, SpaceError, acceptInvite, awaitMatchingMount, createSpace, declineInvite, findMount, getAppMountPath, getInvites, getMounts, getSessionMounts, importSettingsFromParent, listMyInvites, listPendingInvites, listSettingsApps, makeContentRef, mount, mountSpace, onInvitesChange, onMountsChange, onSessionMountsChange, openSettings, openSettingsOf, requestMount, requestSpace, resolveContentRef, resolveContentRefs, revokeInvite, unmountSpace, useInvites, useMounts, useSessionMounts, waitForMount } from './mounts.cjs';
 export { AnalyticsAck, AnalyticsPropValue, emitAnalyticsEvent, recordRoute, track, trackRoute } from './analytics.cjs';
 export { ContributeMode, ContributeOptions, ContributionEvent, ContributionResult, contribute } from './contribute.cjs';
@@ -31,7 +31,8 @@ export { HostFetchInit, HostFetchResponse, HostFetchStreamEvent, HostFetchStream
 export { FeedFetchResponse, FeedParams, feedFetch } from './feed.cjs';
 export { SecretError, SecretGrant, SecretHints, SecretQuery, SecretType, SecretView, getSecrets, onSecretsChange, requestAddSecret, requestSecret, revokeSecret, useSecrets } from './secrets.cjs';
 export { RecentProject, clearRecentProjects, listRecentProjects } from './recents.cjs';
-export { ChatDelta, ChatFeatures, ChatMessage, ChatProviderInfo, ChatProviderState, ChatRequest, ChatResult, ChatRole, ChatStopReason, ContentPart, ToolDef, chat, describeChat, describeChatState, normalizeProviderInfo, onChatProviderChange, onChatProviderStateChange, useChatProvider, useChatProviderState } from './llm.cjs';
+export { OpenRepositoryError, OpenRepositoryErrorCode, RepositoryCoordinates, openRepository } from './openRepository.cjs';
+export { ChatDelta, ChatExecutor, ChatFeatures, ChatMessage, ChatProviderInfo, ChatProviderState, ChatRequest, ChatResult, ChatRole, ChatStopReason, ChatTierModels, ContentPart, ToolDef, chat, describeChat, describeChatState, normalizeProviderInfo, onChatProviderChange, onChatProviderStateChange, useChatProvider, useChatProviderState } from './llm.cjs';
 export { BuildError, ConsoleEntry, ConsoleLevel, Diagnostics, DiagnosticsProvenance, getDiagnostics, onDiagnosticsChange, useDiagnostics } from './diagnostics.cjs';
 export { VcsActionError, VcsBranch, VcsChange, VcsPR, VcsState, getVcsState, onVcsStateChange, refreshDiff, refreshPRs, resetWorkingTree, useVcsState } from './vcs.cjs';
 export { FsChange, MountChange, getFsChange, onFsChange, useFsChange } from './onFsChange.cjs';
@@ -49,6 +50,7 @@ export { EvaluationContext, FileQueryResult, FilesMetadata, Metadata, MetadataQu
 export * from '@immediately-run/safe-content';
 export { AgentEvents, AgentMessage, AgentRole, AgentTool, COMPACTION_MARKER, ContentBlock, ImageBlock, ModelClient, ModelResponse, NUDGE_TEXT, ReasoningBlock, RunAgentOptions, StallReason, TextBlock, TokenUsage, ToolExecutor, ToolOutcome, ToolResultBlock, ToolUseBlock, compactTranscript, detectStall, estimateTokens, isContextOverflow, runAgent, shouldCompact } from './agentLoop.cjs';
 export { INTERRUPTED_TURN_TEXT, STEER_INTERRUPT_MARKER, STEER_MARKER, SteerController, SteerMessage, SteerMode, SteerSource, anySignal, parseSteer, steerWireText } from './agentSteering.cjs';
+export { PauseController, PauseSource } from './agentPause.cjs';
 export { createChatModelClient } from './agentChatClient.cjs';
 export { HeadingSummary, METADATA_HEADINGS_KEY, METADATA_QUERY_TOOL_DESCRIPTOR, METADATA_QUERY_TOOL_NAME, MetadataQueryError, MetadataQueryInput, MetadataQueryRow, createMetadataQueryTool, executeMetadataQuery, globToRegExp, runMetadataQuery } from './metadataQueryTool.cjs';
 export { collectHeadings } from './collectHeadings.cjs';