Function agentQuery

src/agent-backend.ts:539–634

(args: Record<string, any>)

  }

  async function agentQuery(args: Record<string, any>): Promise<{ content: string }> {
    const selector = typeof args.selector === "string" ? args.selector : undefined;
    const mode = typeof args.mode === "string" && args.mode ? args.mode : "text";
    const indexValue = Number.isFinite(args.index) ? args.index : 0;
    const limitValue = Number.isFinite(args.limit)
      ? args.limit
      : mode === "page_text"
        ? DEFAULT_PAGE_TEXT_LIMIT
        : DEFAULT_LIST_LIMIT;
    const timeoutValue = Number.isFinite(args.timeoutMs) ? args.timeoutMs : 0;
    const pollValue = Number.isFinite(args.pollMs) ? args.pollMs : DEFAULT_POLL_MS;
    const pattern = typeof args.pattern === "string" ? args.pattern : null;
    const flags = typeof args.flags === "string" ? args.flags : "i";

    if (mode === "page_text") {
      if (selector && timeoutValue > 0) {
        await waitForCount(selector, 1, timeoutValue, pollValue);
      }
      const pageText = await agentEvaluate(buildAgentPageTextScript(limitValue, pattern, flags));
      return { content: JSON.stringify({ ok: true, value: pageText }, null, 2) };
    }

    if (!selector) throw new Error("selector is required");

    if (mode === "exists") {
      const count = await waitForCount(selector, 1, timeoutValue, pollValue);
      return {
        content: JSON.stringify({ ok: true, value: { exists: count > 0, count } }, null, 2),
      };
    }

    const count = await waitForCount(selector, indexValue + 1, timeoutValue, pollValue);
    if (count <= indexValue) {
      throw new Error(`No matches for selector: ${selector}`);
    }

    if (mode === "text") {
      const data =
        indexValue > 0
          ? await agentCommand("nth", { selector, index: indexValue, subaction: "text" })
          : await agentCommand("innertext", { selector });
      return { content: typeof data?.text === "string" ? data.text : "" };
    }

    if (mode === "value") {
      if (indexValue > 0) {
        const result = ensureEvalResult(
          await agentEvaluate(buildAgentNthValueScript(selector, indexValue)),
          "Value lookup failed"
        );
        return { content: typeof result === "string" ? result : JSON.stringify(result) };
      }
      const data = await agentCommand("inputvalue", { selector });
      return { content: typeof data?.value === "string" ? data.value : "" };
    }

    if (mode === "attribute") {
      if (!args.attribute) throw new Error("attribute is required");