Class McpClient

mcp/src/client.ts:61–451

 * of these per session and may re-pin a resolved single-agent default.
 */
export class McpClient {
  readonly sdk: E2AClient;
  /** Default per-agent address; mirrors the old flat `agentEmail`. */
  readonly agentEmail: string;
  /**
   * The connecting credential's scope (§6a tier-gating signal). Resolved at
   * session init from whoami (GET /account). Defaults to "account" (full
   * surface) so direct constructions / tests are unchanged; buildSessionClient
   * sets the real value per credential.
   */
  readonly scope: Scope;

  constructor(sdk: E2AClient, agentEmail = "", scope: Scope = "account") {
    this.sdk = sdk;
    this.agentEmail = agentEmail;
    this.scope = scope;
  }

  // resolveAddress picks the explicit per-call address, falling back to
  // the pinned default. Throws a directive error when neither resolves.
  private resolveAddress(explicit?: string): string {
    const addr = explicit || this.agentEmail;
    if (!addr) {
      throw new Error(
        "email is required — pass it explicitly, or connect with an agent-scoped credential (which resolves the agent for you). Run list_agents to see your agents.",
      );
    }
    return addr;
  }

  // ── Account / identity ──────────────────────────────────────────

  // whoami → GET /account (§6a): the authenticated principal (user + scope;
  // agent_address only for agent-scoped credentials) + plan/limits. NOT an
  // agent — discover agents via list_agents.
  whoami(): Promise<AccountView> {
    return this.sdk.account.get();
  }

  // ── Agents ──────────────────────────────────────────────────────

  async listAgents(): Promise<AgentView[]> {
    return this.sdk.agents.list().toArray({ limit: DEFAULT_LIST_LIMIT });
  }

  getAgent(address: string): Promise<AgentView> {
    return this.sdk.agents.get(address);
  }

  // create_agent takes a full email (§6a / AG-1/2): a custom-domain agent on a
  // verified owned domain, or an email on the shared domain. slug/agent_mode/
  // webhook_url are gone. Returns the full AgentView.
  createAgent(body: { email: string; name?: string }): Promise<AgentView> {
    return this.sdk.agents.create(body);
  }

  // Consume the generated UpdateAgentRequest directly (no hand-declared
  // duplicate, no cast): a field removed/renamed at the API layer is a compile