@particle-academy/agent-integrations 0.28.0 → 0.28.1

package/dist/index.cjs

@@ -2772,6 +2772,17 @@ function registerNavigationBridge(host, options) {
   const agent = { ...DEFAULT_AGENT11, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const disposers = [];
+  let groundedRevision = null;
+  const staleIntent = () => {
+    const current = adapter.getRevision?.();
+    if (current === void 0) return null;
+    if (groundedRevision === null || groundedRevision !== current) {
+      return errorResult(
+        `Human took control at page revision ${current}. This agent action was cancelled; call page_describe before acting again.`
+      );
+    }
+    return null;
+  };
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = (label, elementId) => ({
     kind: "navigation",
@@ -2812,6 +2823,11 @@ function registerNavigationBridge(host, options) {
     [],
     () => {
       const snap = adapter.describe();
+      const revision = adapter.getRevision?.();
+      if (revision !== void 0) {
+        snap.revision = revision;
+        groundedRevision = revision;
+      }
       const text = [
         `URL: ${snap.url}`,
         `Title: ${snap.title}`,
@@ -2836,6 +2852,8 @@ function registerNavigationBridge(host, options) {
     { handle: { type: "string" } },
     ["handle"],
     (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       const handle = String(args.handle ?? "");
       const action = adapter.describe().actions.find((candidate) => candidate.handle === handle);
       if (!action) return errorResult(`No element for handle "${handle}"`);
@@ -2852,6 +2870,8 @@ function registerNavigationBridge(host, options) {
     { url: { type: "string", description: "Path like /packages or an absolute URL." } },
     ["url"],
     async (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       const url = String(args.url ?? "");
       if (!url) return errorResult("url is required");
       const from = adapter.getLocation().url;
@@ -2878,6 +2898,8 @@ function registerNavigationBridge(host, options) {
     {},
     [],
     async () => {
+      const stale = staleIntent();
+      if (stale) return stale;
       if (!adapter.back) return errorResult("Host did not provide back navigation.");
       await adapter.back();
       return textResult("Went back");
@@ -2890,6 +2912,8 @@ function registerNavigationBridge(host, options) {
     {},
     [],
     async () => {
+      const stale = staleIntent();
+      if (stale) return stale;
       if (!adapter.forward) return errorResult("Host did not provide forward navigation.");
       await adapter.forward();
       return textResult("Went forward");
@@ -2906,6 +2930,8 @@ function registerNavigationBridge(host, options) {
     },
     [],
     (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       const handle = typeof args.handle === "string" ? args.handle : void 0;
       adapter.scrollTo({
         handle,
@@ -2922,6 +2948,8 @@ function registerNavigationBridge(host, options) {
     { dy: { type: "number" } },
     ["dy"],
     (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       adapter.scrollBy(Number(args.dy ?? 0));
       return textResult(`Scrolled by ${Number(args.dy ?? 0)}px`);
     },
@@ -2936,6 +2964,8 @@ function registerNavigationBridge(host, options) {
     },
     ["handle", "value"],
     (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       const handle = String(args.handle ?? "");
       const res = adapter.setField(handle, args.value);
       if (!res.ok) return errorResult(res.error ?? `Could not set ${handle}`);
@@ -2949,6 +2979,8 @@ function registerNavigationBridge(host, options) {
     { handle: { type: "string" } },
     ["handle"],
     async (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       const handle = String(args.handle ?? "");
       const action = adapter.describe().actions.find((a) => a.handle === handle);
       const rect = adapter.rectFor?.(handle) ?? void 0;
@@ -2968,6 +3000,8 @@ function registerNavigationBridge(host, options) {
     { handle: { type: "string" } },
     ["handle"],
     async (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       const handle = String(args.handle ?? "");
       const rect = adapter.rectFor?.(handle) ?? void 0;
       if (pendingMode && adapter.confirm) {