@arcgis/ai-components 5.2.0-next.0 → 5.2.0-next.10

package/dist/chunks/arcgisKnowledgeGraph.js

@@ -1,6 +1,6 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { StateGraph as w, START as y, END as h } from "@langchain/langgraph/web";
-import { a as f, c as x, b as k, d as _, e as b, s as K, q as v, g as p, h as A, t as g, r as M, i as S, G as T, j as u } from "./adapter.js";
+import { a as f, c as x, b as k, d as _, e as b, s as K, q as v, g as p, h as A, t as g, r as M, i as T, G as S, j as u } from "./adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
 import { j as q, s as c, h as C } from "./generateLayerDescriptions.js";
@@ -47,7 +47,7 @@ async function R(e, o) {
   };
 }
 async function N(e, o) {
-  const l = new G(m);
+  const l = new G(m, { handleToolErrors: !1 });
   try {
     const a = await l.invoke(
       {
@@ -106,7 +106,7 @@ async function z(e, o) {
     ...d,
     details: void 0
     // Remove details to avoid overwhelming the LLM with too much info
-  })), { knowledgeGraph: r } = await S(o), n = T.getDataModelTypesSummary(r.dataModel), t = {
+  })), { knowledgeGraph: r } = await T(o), n = S.getDataModelTypesSummary(r.dataModel), t = {
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
     toolResult: a,

package/dist/chunks/dataExplorationGraph.js

@@ -1,258 +1,274 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { StateGraph as b, START as V, END as v } from "@langchain/langgraph/web";
-import { g as T, O as R, P as C, t as N, Q as k, f as y, R as D, r as z, S as $, T as P } from "./adapter.js";
+import { StateGraph as I, START as k, END as v } from "@langchain/langgraph/web";
+import { g as T, O as R, P as C, t as N, Q as V, f as h, R as D, r as z, S as b, T as P } from "./adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
-import { s as l, j as A, h as Q } from "./generateLayerDescriptions.js";
+import { s as n, j as _, h as Q } from "./generateLayerDescriptions.js";
 import { AIMessage as j } from "@langchain/core/messages";
 import "@langchain/openai";
 import "@arcgis/core/core/reactiveUtils.js";
 import "@arcgis/core/layers/FeatureLayer.js";
 import "@arcgis/core/request.js";
 import "@langchain/core/prompts";
-import { h as I } from "./toolCallResponse.js";
+import { h as $ } from "./toolCallResponse.js";
 import { ToolNode as O } from "@langchain/langgraph/prebuilt";
 import G from "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
 import U from "@arcgis/core/smartMapping/statistics/uniqueValues.js";
-const W = async (t, e) => (await l({ text: "Exiting Data Exploration agent" }, e), t), B = async (t, e) => {
-  await l({ text: "Requesting LLM for layer filter results" }, e);
-  const c = await T("data_explore_filter_prompt");
+const W = async (t, e) => (await n({ text: "Exiting Data Exploration agent" }, e), t), B = async (t, e) => {
+  await n({ text: "Requesting LLM for layer filter results" }, e);
+  const d = await T("data_explore_filter_prompt");
   if (!e?.configurable)
     throw new Error("config.configurable is required for layer filter tools");
-  const { userTimezone: n, userTimezoneOffset: r } = R(), o = {
+  const { userTimezone: l, userTimezoneOffset: s } = R(), o = {
     layerFieldInfo: t.layerFieldInfo,
-    userTimezone: n,
-    userTimezoneOffset: r,
+    userTimezone: l,
+    userTimezoneOffset: s,
     queryResponse: t.queryResponse,
     assignedTask: t.agentExecutionContext.assignedTask,
     userRequest: t.agentExecutionContext.userRequest,
     priorSteps: t.agentExecutionContext.priorSteps
-  }, s = await A({
-    promptText: c,
+  }, r = await _({
+    promptText: d,
     modelTier: "advanced",
     messages: t.dataExplorationMessages,
     inputVariables: o,
     tools: C
-  }), i = [...t.dataExplorationMessages, s];
-  if (!((s.tool_calls?.length ?? 0) > 0))
-    return await l({ text: "LLM determined no filter changes needed" }, e), {
+  }), i = [...t.dataExplorationMessages, r];
+  if (!((r.tool_calls?.length ?? 0) > 0))
+    return await n({ text: "LLM determined no filter changes needed" }, e), {
       ...t,
       dataExplorationMessages: i
       // Don't overwrite outputMessage if query already set it
     };
-  const m = [...i, s], g = s.content.toString();
-  return await I(s, e), { ...t, dataExplorationMessages: m, outputMessage: g };
+  const m = i, p = r.content.toString();
+  return await $(r, e), { ...t, dataExplorationMessages: m, outputMessage: p };
 }, H = async (t, e) => {
-  await l({ text: "Requesting LLM for layer query results" }, e);
-  const c = await T("data_explore_query_prompt");
+  await n({ text: "Requesting LLM for layer query results" }, e);
+  const d = await T("data_explore_query_prompt");
   if (!e?.configurable)
     throw new Error("config.configurable is required for layer query tools");
-  const { userTimezone: n, userTimezoneOffset: r } = R(), o = {
+  const { userTimezone: l, userTimezoneOffset: s } = R(), r = t.agentExecutionContext.sharedState.lastNavigatedFeatures, i = r && typeof r == "object" && "value" in r ? r.value : r;
+  let c = "none";
+  if (i != null)
+    try {
+      c = JSON.stringify(i);
+    } catch {
+      c = "none";
+    }
+  const m = {
     layerFieldInfo: t.layerFieldInfo,
-    userTimezone: n,
-    userTimezoneOffset: r,
+    userTimezone: l,
+    userTimezoneOffset: s,
     assignedTask: t.agentExecutionContext.assignedTask,
     userRequest: t.agentExecutionContext.userRequest,
-    priorSteps: t.agentExecutionContext.priorSteps
-  }, s = await A({
-    promptText: c,
+    priorSteps: t.agentExecutionContext.priorSteps,
+    lastNavigatedFeatures: c
+  }, p = await _({
+    promptText: d,
     modelTier: "advanced",
     messages: t.dataExplorationMessages,
-    inputVariables: o,
-    tools: k
-  }), i = s.content.toString();
-  return await I(s, e), {
+    inputVariables: m,
+    tools: V
+  }), f = (p.tool_calls?.length ?? 0) > 0, g = p.content.toString();
+  return await $(p, e), {
     ...t,
-    dataExplorationMessages: [...t.dataExplorationMessages, s],
-    outputMessage: i,
+    dataExplorationMessages: [...t.dataExplorationMessages, p],
+    // Only emit output here when no tools are being called.
+    // For tool-calling flows, downstream summarizer nodes provide the final user-facing message.
+    ...f ? {} : { outputMessage: g },
     status: "success",
-    summary: i ? N(i) : "Query executed."
+    summary: g && !f ? N(g) : "Query planning completed."
   };
-}, K = async (t, e) => {
+}, J = async (t, e) => {
   try {
-    await l({ text: "Requesting LLM for summary on query results" }, e);
-    const c = await T("summarize_query_response_prompt"), n = {
+    await n({ text: "Requesting LLM for summary on query results" }, e);
+    const d = await T("summarize_query_response_prompt"), l = {
       queryResponse: t.queryResponse,
       assignedTask: t.agentExecutionContext.assignedTask,
       userRequest: t.agentExecutionContext.userRequest,
       priorSteps: t.agentExecutionContext.priorSteps
-    }, r = await Q({
-      promptText: c,
+    }, s = await Q({
+      promptText: d,
       modelTier: "fast",
       messages: t.dataExplorationMessages,
-      inputVariables: n
-    }), o = typeof r == "string" ? r : r.content, s = new j(o);
-    await l({ text: `Received response from LLM: ${o}` }, e);
+      inputVariables: l
+    }), o = typeof s == "string" ? s : s.content, r = new j(o);
+    await n({ text: `Received response from LLM: ${o}` }, e);
     const i = o;
     return {
       ...t,
       outputMessage: i,
       status: "success",
       summary: i ? N(i) : "Summary generated.",
-      dataExplorationMessages: [...t.dataExplorationMessages, s]
+      dataExplorationMessages: [...t.dataExplorationMessages, r]
     };
   } catch (a) {
-    throw await l({ text: "Error during filter LLM request" }, e), new Error(`Error during filter LLM request: ${a instanceof Error ? a.message : String(a)}`);
+    throw await n({ text: "Error during filter LLM request" }, e), new Error(`Error during filter LLM request: ${a instanceof Error ? a.message : String(a)}`);
   }
 };
-async function J(t, e) {
-  const c = await new O(C).invoke(
+async function K(t, e) {
+  if ((t.queryResponse ?? []).some((s) => {
+    const o = s.details;
+    return typeof o == "object" && o !== null && "error" in o;
+  }))
+    return await n({ text: "Skipping layer filter tool because query response contains an error." }, e), { ...t };
+  const l = await new O(C, { handleToolErrors: !1 }).invoke(
     {
       messages: t.dataExplorationMessages
     },
     e
   );
-  return await l(
-    { text: `Finished executing layer filter tool: ${c.messages.map((n) => n.content).join(", ")}` },
+  return await n(
+    { text: `Finished executing layer filter tool: ${l.messages.map((s) => s.content).join(", ")}` },
     e
   ), { ...t };
 }
-const X = 10, Y = ["string", "small-integer", "integer"], Z = async (t, e, { includeSummaryStatistics: a = !0, includeUniqueValues: c = !0 } = {}) => {
-  let n = null, r = null;
+const X = 10, Y = ["string", "small-integer", "integer"], Z = async (t, e, { includeSummaryStatistics: a = !0, includeUniqueValues: d = !0 } = {}) => {
+  let l = null, s = null;
   try {
     if (e.type !== "geometry" && e.type !== "oid" && e.type !== "global-id") {
-      a && (n = await G({ layer: t, field: e.name }));
+      a && (l = await G({ layer: t, field: e.name }));
       const o = e.domain?.type === "coded-value" ? e.domain : null;
-      c && (Y.includes(e.type) || o) && (r = (await U({ layer: t, field: e.name })).uniqueValueInfos.sort((s, i) => i.count - s.count).slice(0, X), o && (r = r.map((s) => ({
-        ...s,
-        value: o.getName(s.value) ?? s.value
+      d && (Y.includes(e.type) || o) && (s = (await U({ layer: t, field: e.name })).uniqueValueInfos.sort((r, i) => i.count - r.count).slice(0, X), o && (s = s.map((r) => ({
+        ...r,
+        value: o.getName(r.value) ?? r.value
       }))));
     }
   } catch (o) {
     console.error(`Error fetching statistics for field ${e.name}:`, o);
   }
   return {
-    summaryStatistics: n,
-    uniqueValues: r
+    summaryStatistics: l,
+    uniqueValues: s
   };
 };
 function ee(t, e) {
   return ["string", "small-integer", "integer"].includes(t) || e === "coded-value";
 }
-async function te(t, e, a, c = !0) {
-  const n = [], r = [], o = [];
-  for (const s of t) {
-    let i = function(p) {
-      const d = e.get(p)?.layerItem;
-      return d ? [
-        d.name && `Name: ${d.name}`,
-        d.title && `Title: ${d.title}`,
-        d.description && `Description: ${d.description}`
-      ].filter(Boolean).join(" | ") : p;
+async function te(t, e, a, d = !0) {
+  const l = [], s = [], o = [];
+  for (const r of t) {
+    let i = function(y) {
+      const u = e.get(y)?.layerItem;
+      return u ? [
+        u.name && `Name: ${u.name}`,
+        u.title && `Title: ${u.title}`,
+        u.description && `Description: ${u.description}`
+      ].filter(Boolean).join(" | ") : y;
     };
-    const { layerId: u, results: m } = s, g = a.map?.allLayers.find((p) => p.id === u), S = e.get(u)?.fieldRegistry;
-    if (!S)
+    const { layerId: c, results: m } = r, p = a.map?.allLayers.find((y) => y.id === c), f = e.get(c)?.fieldRegistry;
+    if (!f)
       continue;
-    let h = n.find((p) => p.layerId === u);
-    h || (h = {
-      layerId: u,
-      layerSummary: i(u),
+    let g = l.find((y) => y.layerId === c);
+    g || (g = {
+      layerId: c,
+      layerSummary: i(c),
       fieldInfos: []
-    }, n.push(h));
-    for (const p of m) {
-      const d = S.get(p.name);
-      if (!d)
+    }, l.push(g));
+    for (const y of m) {
+      const u = f.get(y.name);
+      if (!u)
         continue;
-      const f = d.statistics, E = c && !f?.summaryStatistics, w = ee(d.type, d.domain?.type) && !f?.uniqueValues, q = E || w;
+      const x = u.statistics, E = d && !x?.summaryStatistics, w = ee(u.type, u.domain?.type) && !x?.uniqueValues, q = E || w;
       if (o.push({
-        layerId: u,
-        fieldName: d.name,
+        layerId: c,
+        fieldName: u.name,
         didFetchStatistics: q
       }), q) {
-        const _ = Z(g, d, {
+        const A = Z(p, u, {
           includeSummaryStatistics: E,
           includeUniqueValues: w
-        }).then((M) => {
-          const x = {
-            summaryStatistics: f?.summaryStatistics ?? null,
-            uniqueValues: f?.uniqueValues ?? null
+        }).then((F) => {
+          const S = {
+            summaryStatistics: x?.summaryStatistics ?? null,
+            uniqueValues: x?.uniqueValues ?? null
           };
-          E && (x.summaryStatistics = M.summaryStatistics), w && (x.uniqueValues = M.uniqueValues), S.set(d.name, { ...d, statistics: x }), d.statistics = x;
+          E && (S.summaryStatistics = F.summaryStatistics), w && (S.uniqueValues = F.uniqueValues), f.set(u.name, { ...u, statistics: S }), u.statistics = S;
         });
-        r.push(_);
+        s.push(A);
       }
-      h.fieldInfos.push(d);
+      g.fieldInfos.push(u);
     }
   }
-  return await Promise.all(r), {
-    layerFieldInfo: n,
-    didFetchStatistics: r.length > 0,
+  return await Promise.all(s), {
+    layerFieldInfo: l,
+    didFetchStatistics: s.length > 0,
     fieldStatisticsFetchStatus: o
   };
 }
-const F = /\b(average|avg|mean|median|max(?:imum)?|min(?:imum)?|sum|total|count|std(?:dev|\s*deviation)|variance|null\s*count|missing\s*values?|range)\b/iu;
+const M = /\b(average|avg|mean|median|max(?:imum)?|min(?:imum)?|sum|total|count|std(?:dev|\s*deviation)|variance|null\s*count|missing\s*values?|range)\b/iu;
 function ae(t, e) {
-  return F.test(t) || F.test(e);
+  return M.test(t) || M.test(e);
 }
 const se = async (t, e) => {
   try {
-    await l({ text: "Preparing field information for vector search results" }, e);
-    const a = y(e, "layersAndFieldsRegistry"), { mapView: c } = D(e), { assignedTask: n, userRequest: r } = t.agentExecutionContext, o = ae(n, r), { layerFieldInfo: s, didFetchStatistics: i, fieldStatisticsFetchStatus: u } = await te(
+    await n({ text: "Preparing field information for vector search results" }, e);
+    const a = h(e, "layersAndFieldsRegistry"), { mapView: d } = D(e), { assignedTask: l, userRequest: s } = t.agentExecutionContext, o = ae(l, s), { layerFieldInfo: r, didFetchStatistics: i, fieldStatisticsFetchStatus: c } = await te(
       t.vectorSearchFieldResults,
       a,
-      c,
+      d,
       o
     );
-    i ? await l({ text: "Statistics fetched" }, e) : await l({ text: "Statistics skipped" }, e);
-    for (const m of u)
-      await l(
+    i ? await n({ text: "Statistics fetched" }, e) : await n({ text: "Statistics skipped" }, e);
+    for (const m of c)
+      await n(
         {
           text: `  - ${m.fieldName} - stats ${m.didFetchStatistics ? "fetched" : "skipped"}`
         },
         e
       );
-    return await l({ text: "Field information prepared" }, e), { ...t, layerFieldInfo: s };
+    return await n({ text: "Field information prepared" }, e), { ...t, layerFieldInfo: r };
   } catch (a) {
-    throw await l({ text: "Error during fetching statistics" }, e), new Error(`Error during fetching statistics: ${a instanceof Error ? a.message : String(a)}`);
+    throw await n({ text: "Error during fetching statistics" }, e), new Error(`Error during fetching statistics: ${a instanceof Error ? a.message : String(a)}`);
   }
 }, L = 0.7, re = 10, oe = async (t, e) => {
   try {
-    await l({ text: "Similarity search to find fields" }, e);
-    const a = y(e, "fieldSearch"), c = y(e, "layersAndFieldsRegistry"), n = y(e, "embeddingCache"), r = await a.searchFields({
+    await n({ text: "Similarity search to find fields" }, e);
+    const a = h(e, "fieldSearch"), d = h(e, "layersAndFieldsRegistry"), l = h(e, "embeddingCache"), s = await a.searchFields({
       text: t.agentExecutionContext.assignedTask,
       layerIds: t.vectorSearchLayerIds,
       minScore: L,
       topResults: re,
-      embeddingCache: n
-    }), o = r.map(({ layerId: i, results: u }) => {
-      const m = u.map((g) => `  - ${g.name} (${g.score.toFixed(2)})`).join(`
+      embeddingCache: l
+    }), o = s.map(({ layerId: i, results: c }) => {
+      const m = c.map((p) => `  - ${p.name} (${p.score.toFixed(2)})`).join(`
 `);
-      return `${c.get(i)?.layerItem.name ?? i}:
+      return `${d.get(i)?.layerItem.name ?? i}:
 ${m}`;
     }).join(`
 `);
-    let s;
-    return r.length > 0 ? s = `Vector search completed. Matching layers and fields with scores:
-${o}` : s = `No vector search results found for score over ${L}.`, await l({ text: s }, e), {
+    let r;
+    return s.length > 0 ? r = `Vector search completed. Matching layers and fields with scores:
+${o}` : r = `No vector search results found for score over ${L}.`, await n({ text: r }, e), {
       ...t,
-      vectorSearchFieldResults: r
+      vectorSearchFieldResults: s
     };
   } catch (a) {
-    throw await l(
+    throw await n(
       { text: `Error during vector search: ${a instanceof Error ? a.message : String(a)}` },
       e
     ), new Error(`Vector search failed: ${a instanceof Error ? a.message : String(a)}`);
   }
 }, ie = 0.7, ne = async (t, e) => {
   try {
-    await l(
+    await n(
       { text: `Similarity search to find layers: ${t.agentExecutionContext.assignedTask}` },
       e
     );
-    const a = y(e, "layerSearch"), c = y(e, "layersAndFieldsRegistry"), n = y(e, "embeddingCache"), r = await a.searchLayers({
+    const a = h(e, "layerSearch"), d = h(e, "layersAndFieldsRegistry"), l = h(e, "embeddingCache"), s = await a.searchLayers({
       text: t.agentExecutionContext.assignedTask,
       minScore: ie,
-      embeddingCache: n
-    }), o = r.map((u) => u.id), s = r.map(({ id: u, score: m }) => `${c.get(u)?.layerItem.name ?? u} (${m.toFixed(2)})`).join(`
+      embeddingCache: l
+    }), o = s.map((c) => c.id), r = s.map(({ id: c, score: m }) => `${d.get(c)?.layerItem.name ?? c} (${m.toFixed(2)})`).join(`
 `);
     let i;
     return o.length > 0 ? i = `Vector search completed. Matching layers with scores:
-${s}` : i = "Vector search completed. No matching layers found.", await l({ text: i }, e), {
+${r}` : i = "Vector search completed. No matching layers found.", await n({ text: i }, e), {
       ...t,
       vectorSearchLayerIds: o
     };
   } catch (a) {
-    throw await l(
+    throw await n(
       { text: `Error during vector search: ${a instanceof Error ? a.message : String(a)}` },
       e
     ), new Error(`Vector search failed: ${a instanceof Error ? a.message : String(a)}`);
@@ -260,7 +276,7 @@ ${s}` : i = "Vector search completed. No matching layers found.", await l({ text
 }, le = (t, e) => z(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Data Exploration Agent")(
   t,
   e
-), ce = () => new b($).addNode("requireDataExplorationServices", le).addNode("vectorSearchLayers", ne).addNode("vectorSearchFields", oe).addNode("fieldStatistics", se).addNode("queryAgent", H).addNode("queryTools", P).addNode("summarizeQueryResponseLLM", K).addNode("filterAgent", B).addNode("filterTools", J).addNode("earlyExit", W).addEdge(V, "requireDataExplorationServices").addEdge("requireDataExplorationServices", "vectorSearchLayers").addConditionalEdges(
+), ce = () => new I(b).addNode("requireDataExplorationServices", le).addNode("vectorSearchLayers", ne).addNode("vectorSearchFields", oe).addNode("fieldStatistics", se).addNode("queryAgent", H).addNode("queryTools", P).addNode("summarizeQueryResponseLLM", J).addNode("filterAgent", B).addNode("filterTools", K).addNode("earlyExit", W).addEdge(k, "requireDataExplorationServices").addEdge("requireDataExplorationServices", "vectorSearchLayers").addConditionalEdges(
   "vectorSearchLayers",
   (e) => e.vectorSearchLayerIds.length ? "vectorSearchFields" : "earlyExit"
 ).addConditionalEdges(
@@ -277,13 +293,13 @@ ${s}` : i = "Vector search completed. No matching layers found.", await l({ text
   This also includes questions that ask which feature meets a given condition or where a particular feature in the data is located (e.g., “Where is the spring with the highest elevation?”). However, this agent does not handle addresses.
   _Example: “How many features are there?”_  
   _Example: “What’s the average population?”_  
-  _Example: “Which values are in the status field?”_`, Fe = {
+  _Example: “Which values are in the status field?”_`, Me = {
   id: "dataExploration",
   name: "Data Exploration Agent",
   description: de,
   createGraph: ce,
-  workspace: $
+  workspace: b
 };
 export {
-  Fe as D
+  Me as D
 };

package/dist/chunks/data_explore_query_prompt.js

@@ -36,11 +36,26 @@ Latest user request:
 Prior steps:
 {priorSteps}
 
+Last navigated features from shared state (if available):
+{lastNavigatedFeatures}
+
 Use the assigned task as the primary instruction for the current query.
 Use the latest user request as supporting context when needed.
 Use prior steps only when the assigned task or user request clearly depends on earlier results.
+Use lastNavigatedFeatures as authoritative context for map-navigation references when present.
 Use chat history only when necessary to understand conversational references, and do not override the assigned task.
 
+### Anchor selection rule (strict, single source of truth)
+
+When the request is referential (for example: "this", "it", "that", "those", "them", "of those", "the same one(s)"), choose exactly one anchor using this priority order:
+
+1. Explicit entity named in the current request (if present)
+2. \`lastNavigatedFeatures\` (if present)
+3. The immediately previous successful relevant step from \`priorSteps\`
+
+After selecting the anchor, keep that anchor for this query and do not switch to an older entity.
+If \`lastNavigatedFeatures\` is used as the anchor, reuse its \`layerId\` and \`where\` for query scope unless the current request explicitly overrides it.
+
 ### Fresh WHERE clause rule
 
 Start with a fresh WHERE clause for each new question. Do not inherit filters from previous questions UNLESS the assigned task explicitly references previous results (see "Referencing Previously Identified Features" below).
@@ -63,11 +78,9 @@ Start with a fresh WHERE clause for each new question. Do not inherit filters fr
 
 This is an exception to the "fresh WHERE clause" rule above.
 
-When the assigned task uses words like "these", "those", "them", "the same ones" referring to features from a previous turn:
-
-- If the previous query used useCurrentExtent: true → use useCurrentExtent: true with where: "1=1"
-- If the previous assistant response mentions specific objectIds or feature IDs → use {{objectIdField}} IN (id1, id2, ...) to scope to those features
-- If neither is available, use the same WHERE clause and layer from the previous query turn to re-select the same features
+- If the anchored context indicates \`useCurrentExtent: true\`, use \`useCurrentExtent: true\` with \`where: "1=1"\`.
+- If the anchored context includes specific feature IDs/objectIds, scope to those IDs.
+- Otherwise, use the anchored \`layerId\` + \`where\` combination.
 
 ### Mixed Questions