[CI-4659] Rename Assistant Module to Agent

[evanyan13]

PR Type

What kind of change does this PR introduce?

• Refactoring (no functional changes, no API changes)

✅ Definition of done:

• agent import works identically to current assistant
• assistant remains as a deprecated alias.

Tasks

• Move existing functions to agent module

  • Rename all assistant functions to agent

• Import agent functions from assistant module

  • Export with backwards compatible names
  • Add JSDoc deprecation notice to all functions

• Rename all assistant functions to agent in tracker module

  • Export with backwards compatible names
  • Add JSDoc deprecation notice to all functions

• Add tests for agent module in /spec

  • Retain tests for assistant module to support backwards compatibility

• Update README, docs, and TypeScript defs to reference agent

Note:

• Can only pass domain=assistant as a query param to the endpoint: https://agent.cnstrc.com/v1/intent/ now.
  • No need to change domain=assistant – this is customer/integration-specific and may be any arbitrary value to distinguish multiple setups for the same ac_key.

[Copilot]

Pull Request Overview

This PR refactors the Assistant module to Agent, providing a modern interface while maintaining backwards compatibility. The primary purpose is to rename the "Assistant" functionality to "Agent" while ensuring existing integrations continue to work seamlessly.

Key Changes

• Introduction of a new Agent module with updated function names (e.g., trackAgentSubmit)
• Assistant module converted to a wrapper that extends Agent and provides deprecated aliases
• All tracker methods renamed from trackAssistant* to trackAgent* with backwards-compatible wrappers
• Updated service URLs to use agentServiceUrl with assistantServiceUrl fallback

Reviewed Changes

Copilot reviewed 6 out of 10 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/modules/tracker.js	Renamed tracking methods from assistant to agent and added deprecated backward-compatible wrappers
src/modules/assistant.js	Refactored to extend Agent class while maintaining deprecated interface
src/modules/agent.js	New module containing core agent functionality previously in assistant.js
src/constructorio.js	Added agent service URL configuration and instantiated new Agent module
spec/src/modules/tracker.js	Added comprehensive test coverage for new agent tracking methods
spec/src/modules/agent.js	Added test suite for the new Agent module functionality

[esezen]

Great job! Just left 2 very simple comments. Let's also get another review from someone from the team

[mocca102]

Left some totally optional comments. Thank you for working on this. It is looking great!

[esezen]

@evanyan13 the changes look good but some tests are failing both in CI and locally. Do you mind taking a look why?

[evanyan13]

@evanyan13 the changes look good but some tests are failing both in CI and locally. Do you mind taking a look why?

Hi @esezen Thank you for raising the issues!
I have identified the mistake that is causing the failure:

• The behavioral_action endpoints have not been updated to receive agent so I have reverted to use assistant for now. (eg. assistant_submit)
• Do we know if the team has plan to update these endpoints to use agent?

Also, I'm facing a problem on the test buildsI. Here are my observations:

• All of the tests pass on my local, but some of them seems to fail in the github workflow
• Different number of test cases fail each time (~1-3)?
• I found that trackAssistantSubmit and trackAgentSubmit are using the same method, but trackAgentSubmit fails while trackAssistantSubmit passes
  So I think this is likely due to a Timeout error rather than an implementation error.
  Do you think this is something we should follow up/dig deeper about?

[esezen]

@evanyan13

Do we know if the team has plan to update these endpoints to use agent?

Can you please check with ASA team? It's not a blocker for this PR and I will merge this PR today but let's figure out the next steps there.

Different number of test cases fail each time (~1-3)?

We have some flaky tests we need to address but not related to your PR, all good!

[esezen]

LGTM!