Method getAgentByUrl

server/src/agent-service.ts:92–118

* Get agent by URL * Checks registered agents first, then discovered agents

(url: string, options: { viewerHasApiAccess?: boolean } = {})

   * Checks registered agents first, then discovered agents
   */
  async getAgentByUrl(url: string, options: { viewerHasApiAccess?: boolean } = {}): Promise<Agent | undefined> {
    const viewerHasApiAccess = options.viewerHasApiAccess ?? false;
    // Mirror listAgents: API-access viewers can look up members_only agents
    // on private profiles; unauth viewers stay scoped to public profiles.
    const profiles = viewerHasApiAccess
      ? await this.memberDb.listProfiles()
      : await this.memberDb.listProfiles({ is_public: true });

    for (const profile of profiles) {
      for (const agentConfig of profile.agents || []) {
        if (agentConfig.url !== url) continue;
        if (!this.isVisibleToViewer(agentConfig.visibility, viewerHasApiAccess)) continue;
        if (agentConfig.visibility === 'public' && !profile.is_public && !viewerHasApiAccess) continue;
        return this.configToAgent(agentConfig, profile);
      }
    }

    // Check discovered agents
    const discoveredAgents = await this.federatedDb.getAllDiscoveredAgents();
    for (const discovered of discoveredAgents) {
      if (discovered.agent_url === url) {
        return this.discoveredToAgent(discovered);
      }
    }

    return undefined;
  }

  /**
   * Get agent by identifier (URL or legacy slug format like "type/name")